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WELCOME TO 
YOUR OFFICIAL 
PI MAGAZINE! 

O he dream of a digital home has been 

around much longer than the technology 
needed to make it a reality. 1 can remember 
watching the wonderful foward-looking BBC 
program, Tomorrow’s World, when 1 was growing 
up and wondering just what it would be like to live 
in the ^ homes of tomorrow’ that regularly featured 
on the show. 

While technical marvels like optical storage, 
evergreen plastic grass, affordable home 
computers, electronic banking and mobile 
telephones have all become vital parts of our 
everyday lives, the digital homes of the future 
have still very much remained part of tomorrow’s 
world. At least, until now. 

This month we take you on a journey through 
eight Raspberry Pi-powered digital home projects 
that you can use to revolutionise the way you live 
today. Starting on page i8, we’ll demonstrate and 
demystify things like automated lighting, Twitter- 
powered door bells, affordable home CCTV and 
smartphone-triggered garage doors (among other 
things), so you can save time and trouble by giving 
your home the power to better serve you. We might 
not be at the point where our own Robbie the Robot 
can warn us of the dangers of the modern kitchen, 
but 1 honestly think we’re actually getting there. 
Enjoy the issue! 

Russell Barnes 
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FEATURE 



You’ve been buying the print edition of The MagPi in droves. Here’s just a small 
selection of our favourite pictures you’ve been sending us on Twitter... 
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O or the first time ever, 

The MagPi is available in 
print on the high street and 
we he really pleased to report that 
youVe been buying it in droves! 
Wehe really pleased you Ve enjoyed 
the magazine and we look forward 
to many years of bringing you the 
very latest news, projects, tutorials 
and reviews dedicated to the worldh 
favourite credit card- sized PC. 

Some of you have had some 
difficulty finding the magazine on 
the high street, but donh worry - if 
youM like a copy, but your local 
store doesnh stock it yet, you can 
simply visit the Raspberry Pi Swag 
Store online at swag.raspberrypi. 
org and have a print copy delivered 
anywhere in the world. If youM like 
a copy of the magazine to arrive 
on your doorstep at the same time 
every month, you could subscribe 
(and save up to 25% in the process). 

Visit bit.ly/MagPiSubs or see 
pages 26-27 for more details! 
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Raspberry Pi's own Liz Upton 
didn't hove to pay for hers. 
There's got to be some perks 
to such 0 tough job! 


The latest Picodemy contingent in the 
largest magazine selfie we've hod so for! 


Our youngest reader to 
dote, sent in by Chris Leach. 
It Just goes to prove that 
you're never too young to 
learn how to get started 
with Raspberry Pi. 








Allen Heard is looking particularly 
pleased with his latest purchase. 


Raspberry Pi's own Eben Upton rearranging 
the shelves to ensure The MogPi is front 
and centre. 


One of this year's 
Creative Technologists, 
Connor, with o selfie 
within 0 selfie. Thanks! 
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PI WARS II: 

THE RETURN 


The dedicated Raspberry Pi robotics contest is back, bigger and better... 


O hristmas came early last 
December when a host 
of Pi-powered robots 
descended on Cambridge to 
contest the first ever Pi Wars. 

Well, Santa must have already 
read our 2015 wish-list, because 
the event is back! Pi Wars 2015 
will be held on 5 December at the 
University of Cambridge Computer 
Laboratory, a larger venue that will 
enable 32 teams to compete, and 


accommodate over 300 spectators 
and a ^Show and TelP area. 

Organised by Mike Horne and 
Tim Richardson, the idea for Pi 
Wars originated from the high 
level of interest in robotics at the 
regular Camjam events run by the 
pair, ^hn particular, people were 
very excited about the possibilities 
of using robotics to teach about 
electronics and programming in 
schools and at home,^^ says Mike. 



'Vt. 


► 


3 




THE CHALLENGES 


Pi Wars 2015 will feature a 
broad range of remote-control 
and autonomous challenges... 


• Obstacle course (RC) 

• Skittles (RC) 

• Pi Noon (RC) 

• Straight-line speed test 
(auto or RC) 

• Three-point turn (auto) 

• Line follower course (auto) 

• Proximity alert (auto) 

• Code quality 

• Aesthetics 

• Build quality 

• Blogging 


^We had both been avid fans of the 
BBC television series Robot Wars, and 
Tim came up with the initial thought 
of having some kind of robotics 
competition. The ideas just wouldnh 
stop flowing from then on!^^ 

Mike tells us that last year’s 
event was a great success, despite 
not everything going to plan and 
some frantic adding up of scores 
at the end. ^^All of the courses were 
well received and the majority of 
the teams were able to compete 
in the majority of the challenges, 
which is exactly what we wanted. ” 
^We had all kinds of ages taking 
part,” adds Tim,^Trom children as 
young as seven to grandfathers. . . We 
were particularly happy to welcome 
a lot of families, both as competing 
teams and as spectators.” 

Mike and Tim were also pleasantly 
surprised by the range of entries, 
some of which were very slick while 
others were cobbled together from 
whatever was available. ^ We were 
particularly surprised by the success 
of some of the less professional- 
looking but extremely well-built 
entries,” says Mike. ^^The most 
surprising robot was probably the 
one that looked like a pirate ship!” 
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2015 


I, ROBQTEER 


Pi Noon 

While the broad structure of Pi Wars 
2015 will remain the same, Mike and 
Tim have a few changes and surprises 
lined up, including a mysterious 
Ti Noon’ duel which replaces the 
Sumo challenge and requires robots 
to hold a wire. They’re remaining 
tight-lipped on the details of this 
non-destructive challenge, but as 
Mike reveals, “One thing’s for sure: 
it’s going to be explosive!” 

Other changes include Golf 
being replaced by a new Skittles 


based on size rather than build 
cost. “The reason for the change 
is a practical one,” explains 
Tim. “The size of a robot doesn’t 
tend to change much past initial 
conception, whereas the cost of a 
robot could change enough to tip a 
team over into the higher category, 
which means we had to rejig things 
at short notice last year. ” 

Finally, there will also be a 
^Show and Tell’ area where non- 
competing robots are exhibited. 

“At our regular Raspberry Jams, 


The most surprising robot 
was probably the one that 
looked like a pirate ship! 


challenge. The Obstacle Course 
is also being overhauled and will 
feature new obstacles that are 
modular and replaceable, while 
the Line Follower track will be 
improved from last year’s ^ paper 
and Sellotape’ version. In addition, 
they’re introducing a couple of new 
on-paper challenges, judging the 
build quality of the robots and how 
well the teams have blogged about 
their experiences of preparing for 
the competition. 

Another change is in the way 
robots are categorised: this year 
they’ll be split into two groups 


we always have a Show and Tell 
section and we wanted to include 
something similar at Pi Wars,” 
explains Mike. There’s also a 
practical reason: “Due to the way 
the main competition needs to be 
scheduled, there are some times 
where we have gaps. By having 
Show and Tell, it gives people 
something extra to look at!” 

If it’s anything like last year’s 
event. Pi Wars 2015 will be a lot of 
fun. While the 32 competing teams 
have now been selected, spectator 
tickets (free for under-i6s) are 
available via piwars.org. 


DESIGN THE PROGRAMME 

A competition is being run to design the cover for the Pi Wars 2015 
programme that will be given to every competitor and spectator. 
There will be a prize for the winning design. The closing date 
for entries is 1 October - visit piwars.org for more details. 


We chatted to Pi Wars robot maker Brian Corteil, 
who is also making this year’s trophies... 

What prompted you to enter the first Pi Wars? 

It look like it would be a fun day, and it was an 
excuse to build a cool robot. PyroBot came about 
a third [of the way] up the field and it was the 
programmer to blame! 

Were you surprised by some of the other robots 
at the event? 

Yes, there were some cool robots on the day. My 
favourites were the ones from schools and made 
by young engineers. Oh, and PiBorg’s DoodleBorg 
is amazing. 


What was the atmosphere Like? Was there 
a Lot of robot rebuiLding going on? 

The atmosphere was great, very friendly and 
competitive at the same time. Yes, parts were added 
and removed from lots of robots. PyroBot had a 
change of motors and attachments for the different 
challenges, plus adjustments were being made all 
the time. 

Can you tell us a bit more about the design of 
PyroBot and how you've improved it for 2015? 

The design of PyroBot was inspired by Pimoroni’s 
iconic case, and Cannybots’ classic line-following 
robots. I even used an early prototype of their 
BlueBrain robot controller for driving the motors 
and controlled Pyro with their custom controller. 

I wanted PyroBot to be no larger than a Model B+ 
Raspberry Pi - in the end, I used the A+. This year, 
PyroBot has been upgraded with the latest version 
of the BlueBrain and will have caterpillar tracks, 
a complete overhaul of his code, plus a fancy new 
docking station. 


( ^ 
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ASTRO PI 

SECONDARY 

SCHOOL 

WINNERS 

ANNOUNCED 



Results are in from the judges, and code from UK schoolchildren 
will run on the ISS, on Astro Pi: a Raspberry Pi with a Sense HAT 


YOUR 
ASTRO PI 

The Astro Pi’s 
Sense HAT, 
with its 8x8 RGB 
LED matrix, 
accelerometer, 
gyroscope, 
magnetometer, 
pressure 
sensor, and 
combined 
temperature/ 
humidity 
sensor, will be 
available to buy. 
Keep watching 
raspberrypi.org 
for updates! j 


Below Creative, 
cross-curricular, 
and entertaining: 
Thirsk pupils 
produced a 
great entry 


® hen the competition 
started, the UK Space 
Agency’s astronaut flight 
education programme manager 
Libby Jackson told The MagPi : 
^^Every time we run competitions, 
children always have amazing 
ideas that we haven’t even thought 
of.” This competition was no 
exception, and the judges - from 
the UK Space Agency, ESERO UK, 
and leading UK space firms - who 
met at the Raspberry Pi Eoundation 
in Cambridge were ^^blown away by 
how clever some of [the entries] 
were!” Judging followed the BBC’s 
code of conduct for competitions 
- as used on the Blue Peter Mission 
Patch competition - and after 
hours of poring over entries some 
rather wonderful winners were 
announced, to accompany Major 
Tim Peake on his mission to the 
International Space Station (ISS). 



Key Stage 3 

The two winners of the KS3 (11-14 
years) competition both impressed 
the judges. Andy Powell, of the 
Knowledge Transfer Network, 
said: ^^All of the judges were 
impressed by the quality of work 
and the effort that had gone into 
the winning KS3 projects, and they 
produced useful, well thought 
through and entertaining results.” 

Thirsk School’s team, 
Space-Byrds, will use telemetry 
data provided by NORAD (North 
American Aerospace Defense 
Command, perhaps best known 
for its @noradsanta efforts), 
along with the real-time clock 
on the Astro Pi, to work out what 
country’s territory the ISS is above 
and then show its flag on the LED 
matrix, along with a short phrase 
in the local language. 

Thirsk’ s ICT head, Dan Aldred, is 
well known for contributions to the 
Pi community, including reference 
sheets for using the Astro Pi in the 
classroom and for the competition. 
Similarly, Martin 0 ’ Hanlon - who 
helped Key Stage 2 winner Hannah 
Belshaw from Cumnor House Girls’ 
School implement her Minecraft 
data visualisation [see The MagPi 
#34 and github.com/astro-pi] - 
has put together a getting started 
tutorial for the Astro Pi board which 
will ensure that its educational use 
as a sensor board and data logger 


lives well beyond the end of the 
mission to ISS. 

Each of these Astro Pi programs 
has been assigned an operational 
codename that will be used when 
talking about it over the space-to- 
ground radio. Thirsk has the ^ops’ 
name FLAGS, while the other Key 
Stage 3 winner, an environmental 
system monitor by Kieran Wand, 
a year nine pupil at Cottenham 
Village Gollege, will be referred to 
by mission control under the ops 
name MISSION CONTROL. 

Kieran’ s program measures 
the temperature, pressure 
and humidity, and displays 
these in a cycling, split-screen 
display, raising alarms if these 
measurements move outside 
acceptable parameters. The judges 
noted that they were ^^especially 
impressed that code had been 
written to compensate for thermal 
transfer between the Pi CPU and 
Astro Pi sensors.” 

Key Stage 4 

Westminster School’s EnviroPi team 
(ops name: TREES) will use the Astro 
Pi NolR camera in the cupola of the 
ISS to take pictures of the ground. 
These will then be analysed using 
false colour image processing to 
produce a Normalised Differentiated 
Vegetation Index (NDVl) for each 
image, which is a measure of plant 
health. One piece of code will run on 
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ASTRO PI WINNERS ANNOUNCED 


the ISS to capture the images, and 
another will run on the ground after 
the mission, to post-process and 
analyse the images captured. 

Team Terminal, from Lincoln 
University Technical College (ops 
name: REACTION GAMES), also 
won the prize for the best overall 
secondary school submission, 
earning them a photograph of their 
school taken from space by an 
Airbus or SSTL satellite. They made 
a suite of reaction games that record 
response times, to investigate how 
crew reaction time changes over the 
course of a long-term space flight. 
The judges noted that ^This entry 
caused all work to cease during the 
judging for about half an hour! 



II 


RADIATION took their Astro Pi and Camera Module 
to the Rutherford Appleton Laboratory and fired 
a neutron cannon at it to test it was working 


II 


Radiation 

Using the Pi for radiation is a 
very cool application indeed for 
the tiny board. Three pupils from 
Magdalen College School in Oxford 
(ops name: RADIATION) have used 
the Camera Module, blanked off 
against light entry, to produce 
just such a device. The blanked- 
off camera sensor still detects 
the impact of high-energy space 
radiation particles as tiny specks 
of light, the intensity of which 
is calculated by the OpenCV 
computer vision library. 

Two of the schools seized 
fantastic opportunities to test 
their entries. EnviroPi’s TREES 
had the chance to test their code 
by sending the board up in a light 
aircraft to take pictures of the 
ground, and RADIATION took their 
Astro Pi and Camera Module to the 
Rutherford Appleton Laboratory 
and fired a neutron cannon at it 
to test it was working. Their code 
can even compensate for dead 
pixels in the camera sensor, to 
allow for rough conditions during 
launch as well as space radiation 


damage. This is fortunate, as 
before it even faced the neutron 
cannon the camera lost a couple 
of pixels during the journey there! 
Note that while the Pi’s image- 
processing pipeline does have 
automatic bad pixel correction, 
this will be disabled by the Astro 
Pi team, as it would interfere with 
the detection of cosmic rays. 

Ta infinity, and beyond! 

This December, Major Tim will be 
strapped to a cylinder containing 
several thousand tons of rocket 
fuel, and blast off towards the ISS 
with luggage containing all the 
winning Astro Pi boards, including 
the winners of the primary school 
competition (see TheMagPi #34): 
Hannah Belshaw of Cumnor House 
Girl’s School’s Minecra/t data 
visualisation, and Cranmere Code 
Club’s very scientific astronaut 
detection system. 

The SD cards have already been 
burned and code testing is well 
under way. Other entries are also 
on the SD cards, so if Major Tim 
has any downtime during the 


mission, some other code maybe 
run manually - this means several 
schools will be on tenterhooks 
waiting to see if their experiments 
run too. They won’t be the only 
ones: the whole Pi community 
will be watching the skies, and 
the internet, for news from space. 


RETRO ALREADY? 

Although the Astro Pi’s Sense HAT is compatible 
with the Pi 2 (and the A+). the B+ board will 
be accompanying it into space. Stability and 
predictability in hardware and software is very 
important as computer errors can have serious 
consequences when you are in a small metal box 
250 miles from your home planet 

Because of this, in order to maintain the old 
computers on space shuttles. NASA has been 
noted in the past for collecting large stocks of 
vintage computer parts. The space shuttle landed 
after its final mission in 2011, still running its 
original 30-year-old computers with 8086 chips. 

Older equipment was also more robust against 
cosmic rays and other radiation - fortunately 
for the Pi and the astronauts, this isn’t a major 
problem inside the ISS. 
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PICADE FINALLY RELEASED 


PICADE 

FINALLY 

RELEASED 



Celebrate Pimoroni’s third birthday with two versions of the Picade... 


Below The 
Picade Console 
is an excellent 
alternative if 
you want the 
same thing on a 
bigger screen 


O f you cast your mind all 
the way back to 2012, or 
Raspberry Pi Year One in 
comic-book origin terms, youRl 
remember one of the very first 
cases to really stand out for the 
Raspberry Pi was Pimoroni’s 
Pibow: a laser-cut, acrylic kit you 
assembled yourself that was, and 
still is, very fun. 

Not long after this success, 
Pimoroni started a Kickstarter 
for the Raspberry Pi-powered 
arcade machine kit, Picade. 

Made up of a special, custom PCB 
and a cabinet kit that made use 
of the team’s established case 
skills, the Kickstarter ignited the 
imagination of hundreds of people. 
625 of them backed the project, 
funding Pimoroni to actually make 
the arcade kit. 

It’s been a while since then, and 
though the Picade has been delayed 
a bit, the final product is now 
here, just in time for Pimoroni’ s 
third birthday. In that time, a 



lot of changes have happened in 
the Raspberry Pi scene, and the 
biggest change from Picade’ s 
original spec is that it now supports 
the Raspberry Pi 2 and B+ form 
factor over the original Pi. 

The physical kit itself 


basically functioning as an arcade 
stick that you can plug into your 
TV to play Sonic and other classic 
games. It’s a lot better than the 
loo-in-i Mega Drive knockoffs 
you get around Christmas 

time, though, as it’s fully 


The lovely Picade PCB 
is what makes the 
whole thing possible 


II 


If you want to celebrate 
Pimoroni's birthday in style 


II 



looks lovely, with black powder- 
coated panels for that proper 
arcade machine look and feel, 
along with great art and a full six- 
button layout. Perfect for failing to 
overthrow M. Bison in Street Fighter 
II (again)! 

As well as the full original kit, 
Pimoroni also has a surprise in the 
shape of the Picade Console. It’s 
a stripped-down version of the 
Picade which lacks the LCD screen. 


moddable and will play any game 
compatible with the selection 
of emulators included. 

To celebrate Pimoroni’s birthday 
in style, go to shop.pimoroni.com 
and grab a Picade for £180, or a 
Picade Console for £90. You can 
also find the Pibow cases that 
made them famous three years 
ago. Happy birthday, Pimoroni! 
Here’s to many more years of great 
Raspberry Pi accessories! 
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GoPiGo 

Everything you need to 
build a Raspberry Pi robot! 


BrickPi 

Build a LEGO robot with 
your Raspberry Pi! 




GrovePi 

Connect hundreds of sensors 
to your Raspberry Pi! 


www.dexterindustries.com 
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CARRIE 

ANNE 

PHILBIN 


PI, PYTHON & 

PIONEERING 

EDUCATION 


The Raspberry Pi Foundation’s education pioneer Carrie Anne Philbin tells 
us about her mission to revolutionise the teaching of computer science 


t’s the best job in the 
world! exclaims Carrie 
Anne Philbin about 
working for the Raspberry Pi 
Foundation. While she enjoys 
the chance to play with new 


As such, her job involves 
flying around the globe to 
talk to teachers and speak at 
conferences. We caught up with 
her at PyCon Australia, where 
she was giving a keynote speech. 





I'm trying to change the world and 
I really believe that at Raspberry Pi, 
that's exactly what we're trying to do 


II 


technology and robots, however, 
she takes her role as the 
Foundation’s education pioneer 
extremely seriously: always say 
Pm trying to change the world and 
1 really believe that at Raspberry 
Pi, that’s exactly what we’re 
trying to do.” 


As a newly elected member of 
the Python Software Foundation 
(PSF) board, Carrie Anne is keen 
to influence the direction of the 
popular programming language 
to make it easier to use in schools. 
^Wor me, it just felt like the PSF 
weren’t really doing anything 


specifically for education. So one 
of the first things 1 did when 1 was 
elected to the board was send this 
really long email saying ^What 
is our mission statement with 
regards to education? These are 
the things 1 want to do’.” This 
resulted in PSF founding member 
Marc-Andre Lemburg suggesting 
she set up a working group for 
education, which was announced 
by Carrie Anne at the recent 
EuroPython 2015 conference in 
Bilbao, Spain, and has since been 
approved by the board. 

It seems things have come 
full circle, since Carrie Anne 
reveals that it was the Python 
community that was the first to 
welcome her when she was still 
working as an ICT teacher at an 
East London school. And, while 
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EDUCATION SUMMIT 

EuroPython 2015 featured an Education 
Summit organised by Carrie Anne’s team at the 
Raspberry Pi Foundation. While she concedes 
that it wasn’t that well attended by teacher 
mainly due to the newness of the event, she 
thinks the numbers will grow in subsequent 
years. In addition, she notes that more and 
more conferences are featuring education 
tracks, including PyCon Australia: "This one 
was really interesting because most of the 
presentations were made by teachers, which 
for me was really exciting because I’d never 
been to a developers’ conference and had 
teachers so well represented. I keep asking 
people in my keynotes, if you run conferences 
then try and add an education track to them. 

So I definitely think they’re going to become 
more popular.’’ 



she is a big fan of the community 
and says they canh really do 
enough for anybody, she admits 
to being really nervous before 
talking about some education- 
related Python bugbears in her 
EuroPython keynote speech. 
^^Before 1 went, 1 spoke to a few 
Python developers, [including] 
Dave Jones, who created the 
PiCamera library... and he went 
^Ooh, 1 wouldnh do that!’ 1 spoke 
to [Sonic Pi creator] Sam Aaron 
too and he said ^Well, good luck!’ 
However, afterwards the reaction 
has been really, really positive.” 

Python barriers 

In that memorable EuroPython 
keynote, Carrie Anne listed a series 
of barriers to teaching Python 
effectively in schools. One was 
a confusing lack of consistency 
from developers in the naming of 
functions, although she admits 
this won’t be easy to solve: You’ re 
almost asking people to change 
the way they use the language. ” 
Another issue raised was the 
compatibility problems between 
Python 2 and 3, for which she has 
a simple solution: everyone should 
use Pythons! 

Possibly a bigger obstacle is 
the need for teachers to install 
extra libraries on a classroom 
of computers, which can result 

raspberrypi.org/magpi 



WHY PYTHON? 


Out of the many text-based programming 
languages. Carrie Anne believes Python is the 
ideal one for teaching purposes. "Ilt’sl probably 
one of the easiest languages to get started with. 

If you look at writing ‘Hello world’ in Java, you’ve 
got four or five lines, curly braces, really random 
words in there; whereas with Python you just 
write ‘print’ and then you’ve got your brackets 
and whatever your string is... that’s one line.’’ 

As well as its ease of use, she points out that 
Python has real-world applications: "It’s not Just 
an education language; it’s also used every day 
by developers in places like Google. CERN, and 
NASA. It’s a real language used by real developers 
around the world, with a growing community.’’ 


in many learners falling down 
early on. It’s a particular hassle 
since, for the protection of pupils, 
many schools keep classroom 
computers offline or have firewalls 
that prevent the downloading 
of libraries. When Carrie Anne 
discussed this issue with Pygame 
Zero creator Daniel Pope, he 
came up with the idea of an 
^educational bundle’ of commonly 
used dependencies that would be 
downloaded on top of the standard 
Python library. Carrie Anne 
explains the concept: ^^Educators 
[will] download the bundle that 
includes Python 3, things like 
Pygame Zero, extra libraries 
they might need, and this new 
text editor.” 

The text editor in question 
is an intended replacement 
for IDLE, another of 
her Python barriers. 

Although there are 
many alternatives, 
she points out 
that IDLE is what 
children have first 
access to since it 
comes included 
with Python. 

So it needs to be 
quick and easy to 
get started with, 
particularly as 
it can be difficult 
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for pupils to make the leap from 
visual programming languages like 
Scratch. While she’s taken a look 
at A1 Sweigart’s IDLE Reimagined 
project (and hopes he’ll join her 
working group), she feels it doesn’t 
really go far enough. After talking 
to prominent members of the 
Python community, including 
Python creator Guido van Rossum, 
Carrie Anne reckons it’ll make more 
sense to move away from IDLE and 
start again with something new. 

^^There are some good things 
about IDLE, as much as we all 
hate it,” she laughs, ^^and one 
of the things we want to keep 
is how simple it is.” Rather 
than having the text editor 


in a separate window, she’d like 
to see everything placed together 
in a single paned window. ^^That 
would be really helpful, and just 
some nice buttons that say ^Run’ 
and ^Stop’, and maybe some nice 
error reporting, but still be really, 
really lightweight. ” 


The four Rs 

Carrie Anne thinks computer 
science should be on a par with the 
other fundamentals of education: 
^^Reading, ’riting, ’rithmetic, 
and Raspberry Pi. . . the four Rs ! ” 
Naturally, the Pi really comes into 
its own for physical computing, 
which is another important aspect 
of teaching computer science 


Founded by Carrie Anne in early 2014, Picademy 
is a free professional development experience 
for primary and secondary teachers. Over the 
course of two days, 24 teachers get hands-on with 
computing and discover the many ways in which 
the Raspberry Pi can be used in the classroom. 
While the main Picademy programmes are run 
at the Raspberry Pi Foundation's Cambridge 
HQ. the initiative has recently been extended 
to Google Garages in Leeds and Birmingham 
in the UK; run by volunteers in these venues, 
there are standard two-day courses as well as 
‘Bytes’ evening classes. There are also plans for 
four Picademy events in the USA next year, and 
Carrie Anne is constantly receiving requests to 
take it out to more countries. However, she says 
it will take some time to come up with a viable 
strategy for scaling it up: “We’re still a small team 
and we need to think about how we can best 
reach teachers globally. The answer is probably 
not running a two-day course in every country 


EXPANDING PICADEMY 
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We write materials, we run 
events, we have an annual 
diversity conference, 


II 


since it gives learners immediate 
feedback. ^^They can see instantly 
what’s happening and say ^oh, 

1 can just modify this bit of code 
and something else happens - 
that’s really exciting’/’ says Carrie 
Anne. Even so, younger children 
may lack the motor skills required 
to work directly with the Pi’ s 
GPIO pins, which is where add- 
on boards prove useful: ^^Things 
like the Pi-Stop [traffic light] 
are fantastic, [while] Pimoroni’s 
Flotilla is a great idea to connect 


WELCOME TO PYLAND 



After helping Sam Aaron to 
develop Sonic Pi, Carrie Anne 
is now involved in the creation 
of a new educational tool 
called Pyland. Developed by 
a team of interns led by Alex 
Bradbury at the Cambridge 
Computer Lab, this is a game 
that will run on the Raspberry 
Pi and teach children how 
to program in Python. It’s an 
attempt to solve the problem 
of moving children from a 
visual programming language 
to a text- based one. 

"I’m really excited about 
this game,’’ says Carrie Anne. 
"I’ve seen demos and I think 
by the end of the summer we 
might have something we can 
start testing with children. 

[It’ll] be really exciting to have 
something that’s like Sonic 
Pi but is Python-based and 
maybe a bit different.’’ 


much bigger cables. ” 

It’s not just the pupils who 
may need extra help, however. 
According to a recent TES survey, 
6o% of teachers didn’t feel 
confident about delivering the new 
computing curriculum in England. 
And with little government 
funding (about £170 per school) 
available for upskilling, the Pi 
Foundation’s free Picademy 
teacher training events are likely 
to be in even greater demand. 
Fortunately, the programme has 
recently been extended to provide 
courses in Leeds and Birmingham 
(see ^Expanding Picademy’ box). 

Carrie Anne is hugely excited 
about the new computing 
curriculum; launched in September 
2014, it requires primary 
schoolchildren to be taught how to 
apply the fundamental principles 
and concepts of computer science, 
which includes learning how to 
program. She says it’s a good 
starting point, but thinks there’s 
still a long way to go and it isn’t 
necessarily being taught everywhere 
or taught well. think it’ll be 
interesting in five or six years’ time, 
[when] the children who at age five 
were learning this new curriculum 
move to secondary school, to see 
what kind of impact that has. ” 
However, she insists that it’s not 
all about coding. ^We’re teaching 
computational thinking, problem 
solving... It being called a coding 
curriculum [by the media] is a real 
red herring. Coding is one strand 
out of three, and digital literacy 
is still part of the curriculum, 

[as is] understanding how 
the internet works. ” 

Carrie Anne strongly believes 
that improved teaching of 
computer science in general will 
benefit society in the future. 

^^Not just the curriculum or 
children learning computational 



WOMEN IN TECHNOLOGY 


While Carrie Anne is impressed by the level of 
diversity in the Python community, including eight 
of the 12 members of the PSF board being women, 
she’s concerned about technology being a male- 
dominated field. One reason is a 'leaky bucket’ 
effect, as women working in technology are "leaving 
in their droves’’. She says one possible solution is 
having more female groups for women who code to 
meet up. "I’ve been to a few PyLadies meetups and 
actually, it’s been really good.’’ 

The other problem is a 'leaky pipeline’: "Girls in 
schools are less likely to end up in the tech industry. 
So I think, first of all, introducing the [computing] 
curriculum at the age of five will help... I think we 
need to keep up this idea that we [teach] girls and 
boys with this gender-neutral approach.’’ 

Carrie Anne is also the chair of Computing At 
School’s ’#include’ initiative to get more girls and 
minority groups into computing. "We write materials, 
we run events, we have [an annual] diversity 
conference. We ran something recently called 'hack 
the curriculum’ where we had teachers and industry 
people together in a room creating a free wiki book... 
We’re just a group of volunteers, so I think what we’ve 
achieved has been staggering really.’’ 

In addition, Carrie Anne runs the award-winning 
'Geek Gurl Diaries’ YouTube channel, which she says 
is still going, despite a lack of recent new content: 

"I am going to try desperately to make some more 
videos, but time is my enemy.’’ 


thinking, but if they learn about 
open source and free software, 
use it and are enabled by it, or make 
their own programs and make them 
free to use by other people, that 
kind of philosophy will help society 
greatly. Not all of them are going 
to grow up and be professional 
developers - what we want is for 
children to grow up and be able to 
solve problems in a creative way. . . 
and change society for the better.” 
and 1 think they will. ” 
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DIGITAL HOME AUTOMATION 
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The Raspberry Pi is perfect for livening up the home. 
Discover some of the smartest home automation 
projects and make your house a whole lot smarter^ 

Lucy Hattersley 


^1^ ack in the 1950s, scientists seemed obsessed 
■ K creating the home of the future. In this 
mythical home, everything would be smart 
and things would just get done for you. 

There’s been a real resurgence in this idea lately 
due to the Internet of Things (loT) concept, where tech 
firms are linking everyday items to the internet. 

Thanks to the power of the Raspberry Pi, you can 
build the home of the future right now. You may not get 
to live like the Jetsons, but youTl end up with a smarter 
home and youTl learn a lot along the way. 

All you need are a few good tutorials. In this feature, 
we’ve found the best home automation projects 
around, and asked the project creators to share 
their secrets. 

The Raspberry Pi is perfect for home projects. It’s 
small, and it drains relatively little power. And with the 
Internet of Things promising to hook all our household 
gadgets up to smart data, there’s never been a better 
time to learn about building a smart home. 

The great news is that lots of people are way ahead, 
and there’s a huge range of practical projects out there 
with good instructions to copy. 

Read on to start building your dream home. . . 


Hooking up a garage 
door to a Raspberry Pi 
enables you to open and 
close it from your smartphone. 


1 
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Maintain a steady 
temperature in your home 
by recreating a Nest-style 
home heating system. 


O Keep everything in 
your house safe with 
motion-activated HD 
surveillance cameras. 


Connecting your Raspberry 
Pi to the television or hi-fi 
can turn any old TV into a 
smart entertainment centre. 





u 
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Daniel is an engineer, geek, and 
programmer who works at Plastic Logic 
in Cambridge. 

muacksandglomps 


feature 


DIGITAL HOME AUTOMATION 


The button is mounted 


in a custom laser-cut 


case. The wire leads 


through to the Raspberry Pi. 


The Raspberry Pi 
Listens for a button 


push, and sends an alert 
to your device via Pushbullet. 


PEBBLYPI 
INTERNET 


'You’M 

‘Need 


> Rugged metal 
push-button 


> Android device 
or iPhone 

> Optional: 
Pebble 

smartwatch or 
Apple Watch 

> lOK Pull-up 
resistor 

> MuLticore cable 


> PC speakers 

> Optional: 
Adafruit Pi Plate 

> Edimax Wi-Fi 
150Mbps mini 
USB adaptor 


DOORBELL 

Daniel Garden never misses a visitor. His doorbell is 
hooked up to a Raspberry Pi, which sends messages to his 
smartphone and Pebble watch when pushed 


The doorbell is a great place to start 
smarting-up your home. People 
push it and a speaker makes a noise, 
usally a ding-dong. It’s simple and 
already has a button, but where’s 
the fun in a regular doorbell? 

It’s easy to hook that button 
up to a Raspberry Pi and get it to 
notify you in a more creative way. 
And one person who’s created a 
doorbell smarter than most is Daniel 
Garden. His PebblyPi Doorbell sends 
a message to his Pebble smartwatch 
whenever somebody pushes the bell. 


^When 1 am in the garage, 1 can’t 
hear the bell,” says Daniel. The 
Pebble watch has haptic feedback 
(thanks to a vibration motor inside 
it) and its tap is hard to miss. 

smart doorbell is one that 
can provide status information 
to other devices,” Daniel tells 
us. ^^The PebblyPi can do this by 
initiating push notifications to my 
smartphone, and my watch, using a 
free online service called Pushover.” 

The parts needed to make a 
PebblyPi are reasonable easy to 


source. You need a push-button for 
the doorbell itself, some telephone 
cable, a WiFi module, and some old 
computer speakers. 

Daniel wired his custom button 
up to a Raspberry Pi Model B and 
used an Adafruit Pi Plate to make 
the wiring easier. It’s a pretty cheap 
project: the push-button cost 
around $5 / £3 and the WiFi module 
$12 / £8. The Pi Plate is $15 / £10, but 
this is an optional extra. 

Daniel had a stylish mount for 
the button created using a laser 
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cutter and hooked it up to the 
Raspberry Pi. Daniel explains: 
^‘The Raspberry Pi provides the 
button press detection. It also 
hosts the Python script that takes 
this button detection, plays an 
MP3, and pushes a notification to 
Pushover (pushover.net). 

^^My Raspberry Pi runs out-of- 
the-box Raspbian,’^ continues 
Daniel, wrote the script that 
handles all the functionality 
in Python, and it autoruns on 
startup.’^ You install Pushover 
on your smartphone. It^s enabled 
through an API key and set up to 


Daniel wired his custom button up to a 
Raspberry Pi Model B and used an Adafruit 
Pi Plate to make the wiring easier 




Whenever the doorbell 
button is pushed, the 
connected Raspberry 
Pi sends an alert 
directly to your iPhone 
or Android phone 



If you have a smartwatch (such as a Pebble) connected to your 
phone, the doorbell alert will appear on that, too 


MEDIA SYSTEM 

Installing software 

It’s easy to hook a Raspberry Pi up to your television or 
hi-fi and create a home media system. The main tool 
used to turn your Raspberry Pi into a smart television 
is called Kodi (kodi.wiki/view/Raspberry_Pi). The 
easiest way to set Kodi up on your Raspberry is via 
NOOBS. Use the Raspberry Pi’s HDMI socket to 
connect directly to an HDTV. 


Author; Alaotoir, BuZz, Dink, dIakieOZ 
Version; 2.7.1 

SotnmiFv; TV oml fiHen to rwho from Itw 0BC‘a iPtojwr wet 


this XBMC pEugin enobtes {UK oril^ th# ploying of tV nod atudio 
catchup content from the BBC I Player webalte. Live radio ortd TV 
feeds are also supported. 


work with the Pebble smartwatch. 
Pushover can also send messages 
to Android and iPhone devices, as 
well as to the Apple Watch. 

Once you have everything 
figured out, it’s a quick 
installation and setup. Building 
the custom button took an hour 
with a laser cutter, and putting 
the code together took Daniel even 
O less time. ^Bt’s easily a weekend 
project,” he tells us. 

Remember to ^^go open source 
and post your code so others can 
build on it,” says Daniel. ^^There 
are a lot of closed smart home 
ecosystems, but when it comes to 
home automation, 1 want to know 
how it all works. Data security is a 
big deal and the only way to know 
that is through open source.” 


Hook up to a hi-fi 

If you’re more interested in creating a music centre, 
use Pi MusicBox (pimusicbox.com).The Raspberry 
Pi’s 3.5mm mini-jack can be used to plug directly into 
most music systems. In both cases, you’ll probably 
need a USB Wi-Fi adaptor (thepihut.com/products/ 
usb-wifi-adapter-for-the-raspberry-pi). 



:0 





Making a remote 

Controlling a home media system from a keyboard 
and mouse is largely impractical, so it’s best to 
set up a remote control once the system is tested 
and working. The best way to do this is to turn a 
smartphone into a remote. Pi Musicbox has a built-in 
web interface, whereas Kodi (kodi.tv) has an official 
remote app available for both Android and iPhone. 


KODI 
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BUILDING A 
NEST-STYLE SMART 


fETHERM^STAT 

William Thomas didn’t buy a Nest like everybody else; he built 
his own home heating system with several Raspberry Pi units 


0 


William Thomas is no stranger to 
air conditioning, and his Raspberry 
Pi Thermostat is a great introduction 
to home temperature control. 

^hVe worked with Nest in the 
past/^ says William. ^^My last job 
used it for their air conditioning in 
the office. 1 had to do tech support 
on it, and that got me wondering if 1 
could build my own with a Raspberry 
Pi. 1 could have bought a Nest, 
but 1 like the challenge of making 
things myself. 

Maintaining a decent room 
temperature is an issue that plagues 
people throughout the world. 
wanted to solve the problem at 


my apartment of not being able to 
control or monitor the temperature 
remotely, as well as the temperature 
differences between the living 
room and the bedroom,’’ explains 
William. ^^My bedroom heats up 
faster than the living room, but 
the original thermometer is in 
the living room, so there was a 
problem there.” 

The Raspberry Pi thermostat 
hooks up to William’s air- 
conditioning unit or heater. It 
can intelligently monitor the 
temperature, but, more importantly, 
it can also be used remotely to turn 
both systems on and off. 


'You’a'Necd 


> 3x Raspberry Pi devices 

> 2x DS18B20 temperature sensors 


> SainSmart 4-channeL relay module 


> HVAC controller software 


^^Because the Raspberry Pi is 
connected to the thermostat,” 
discloses William, ^R’mnow 
able to turn on the air conditioner 
or heater [while] away from 
home. During Los Angeles 
summers, turning the air 
conditioning on as I’m leaving 
work is really convenient. ” 
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The SainSmart relay is wired between the 
Raspberry Pi and the HVAC control unit 



William used three Raspberry 
Pis in his project. Two were hooked 
up to thermometers to monitor 
temperature, while the third was 
connected to his HVAC (heating, 
ventilation, and air conditioning) 
control unit. The layers of software 
are placed into separate Raspberry 
Pis and they all communicate with 
each other. 

have one Raspberry Pi attached 
to the HVAC controller on the 
wall,^^ William tells us, ^^and 1 
have multiple Raspberry Pis that 
each have a thermometer wired 
to their GPIO pins.^’ William 
used DS18B20 digital sensors to 
monitor temperature. 

The other Raspberry Pi is 
connected to the HVAC unit via a 
SainSmart 4-channel relay module. 
The multiple Raspberry Pi units 
increase the cost of the project, 
but aside from that, the parts are 
relatively cheap. ^^Each temperature 
sensor was about $4 [£3],’^ reveals 
William, ^^and the relay module 
was under $10 [£6]. 1 had some 
GPIO jumper wires left over from 
previous projects, but theyhe 
pretty inexpensive. ’’ 

You could get away with just 
two Raspberry Pi units, or even 
one if you place the temperature 
sensor with the air-conditioning 
unit, although this would give 
an inaccurate reading of the 
temperature. ^^The Raspberry 
Pi acts as the internet bridge 
for the project, as well as the 
HVAG controller. 

^^Because Pm using two 
thermometer Pis (one in the living 
room and one in the bedroom). Pm 
able to get a much more accurate 


average temperature within 
my apartment.^’ 

All of the Pi software was written 
in Python and is available on GitHub. 
^‘The web interface uses basic PHP 
andMySQL,^’ says William. ^^For 
the Raspberry Pis, 1 developed 
the system using a ^separation of 
responsibilities’ approach which 
became five separate Python scripts 
that do different things. The main 
script for the HVAC controller Pi 
takes into consideration the set 
temperatures and the current 
temperatures, and interacts with 
the relay module accordingly. The 
main script for the thermometer Pis 
interacts with the DS18B20 sensor 
to record the current temperature at 
that location.” 

It’s not an easy project to take 
on, but building a smart thermostat 
is very rewarding. William tells us 
he worked for a month on and off, 
but he got the software done weeks 
before installing the HVAC. 

However, it’s essential that you 
make sure you know exactly what 
you’re doing when working with 
electrical devices. ^^Do not mess 
with mains electricity,” warns 
William. ^^The HVAC panel in my 
apartment used a low-voltage DC 
current (which made the relay 
module somewhat overkill). 
However, some are built using 
mains electricity, meaning high- 
voltage AC current (in the US, 
anyway). Always test home circuits 
with a multimeter, and know where 
your breaker box is and how to use it. 
The worst thing you could ever do is 
start touching random wires inside 
your walls without knowing what 
you’re doing. Safety is always the 
most important thing.” 






Chris is a engineer from Sioux Falls, 
South Dakota. He works as a personal 
systems analyst at Sanford Health. 

driscocity.com 


OPENER 

Chris Driscoll’s Idiot’s Guide to a Raspberry 
Pi Garage Door Opener is the perfect way to 
learn about door automation 
Garage doors are inherently annoying. You typically 
have to get out of your car, open the garage door, get 
back in the car, drive into the garage, get out of the car 
again, and then close the garage door. 

It’s no wonder that garage doors are one of the first 
things people look to automate in the home. "I had 
never used, or really thought of using a Raspberry 
Pi for anything at all, or anything related to home 
automation," says Chris, "but this really piqued my 
interest. It’s just really cool." 

His blog post details how he went about building 
the automated garage door. Like William Thomas’s 
smart thermostat, he uses a SainSmart 4-channel relay 
module between the Raspberry Pi and garage door 
opening system. The relay module enables you to 
control equipment with a large current. 
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DIGITAL HOME AUTOMATION 


A USB Wi-Fi adaptor is 
used to connect to the 
Raspberry Pi and enables 
video viewing from a remote Location 




Christoph Bunger is the CEO of Scavix 
Software Ltd, his own software 
development and consultant company. 

scavix christophb/ 


SURVEILLANCE 

A K A Create a ‘fake’ CCTV cam that’s better than the real thing. 

/ \ I \ / I This HD Surveillance Cam keeps an eye on your things when 
V V / \ I I you’re not around 


^ouU 

i^eed 

• 

> Raspberry Pi 

> Pi Camera 
Module 

>FakeCCTV 

housing 

> Motion 

J 


Few people are keen on the high 
number of CCTV systems in use in 
the UK, but there’s a good case for 
watching over your own place with 
a remote camera. 

Surveillance cameras can be 
extremely expensive to purchase, 
but with a Raspberry Pi and 
the Pi Camera Module, you can 
create a camera recording system 
that’s much smarter than your 
average surveillance cam. 

Christoph Bunger took things 
a step further, and created a 
Raspberry Pi camera unit housed 
inside a fake CCTV camera case 
(these are sold on Amazon to deter 


would-be thieves). ^‘Thevery 
special thing about this cam,” 
reveals Christoph, ^hs that it uses 
a camera housing that is sold very 
cheap on the net as fake security 
cams. These housings are perfect 
for the Raspberry Pi and cost only 
a few euros. 

^^Our Raspberry Pi surveillance 
cam project is a manual for 
everybody to build their own 
surveillance cam to monitor a 
house, office, or whatever. It’s 
based on the Raspberry Pi, which is 
very versatile and cheap. Everybody 
with beginner-level skills in 
electronics can build it. ” 


With a Raspberry Pi and Camera Module, you can 
create a camera recording system that's much 
smarter than your average surveillance cam 

Ij 

September 2015 



Even though it’s cheaper, and 
housed in a fake case, the Raspberry 
Pi Camera Module is much more 
capable than CCTV cameras 
that typically cost thousands of 
pounds. The Pi is connected via 
SSH to any computer on your 
local network, which can then 
snap photographs and record 
video. You can also access a live- 
stream of the camera remotely. 



If you position the Raspberry Pi carefully inside 
the CCTV housing, it’s difficult to spot, and most 
would-be thieves won’t examine the insides of 
the housing 
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The camera is installed outdoors and looks just 
as convincing as a regular CCTV unit, only it’s far 
more powerful 




Christoph’s smart surveillance project places a 
Raspberry Pi and Camera Module inside a fake 
CCTV camera housing 



housing a Raspberry Pi and Camera Module 


SO it’s ideal for keeping an eye on 
your property whenever you’re 
away from home. 

^‘The Raspberry Pi captures the 
stream from the Camera Module 
and saves it to the SD card or a 
shared folder on a network PC 
when it detects movement/’ 
explains Christoph. ^^Soyou can 
look through the videos later and 
see what happened when you were 
not at home.” 

In order to build the project, 
you’ll need a Raspberry Pi, official 
Camera Module, and that fake 
CCTV housing. 

^^The Camera Module is the most 
expensive part,” says Christoph, 
^^but even that only costs around 25 
euros.” You can pick up a fake CCTV 
camera housing from Amazon for 
as little as £10 / $16. 

^ht took us a half day figuring out 
how to assemble the hardware,” 
says Christoph, ^Then another few 
hours on installing and configuring 
the software.” 

While the original version of 
the project employed Motion 
for the surveillance 


software, Christoph says he’s now 
using motionEye (bitbucket.org/ 
ccrisan/motioneye/overview) . 

After putting the project 
together, Christoph uploaded 
a tutorial to CodeProject 
(bit.ly/iEs982j) and step-by-step 
instructions to Instructables 
(bit.ly/iMs6j9C). These tutorials 
have had over two million views 
so far, so there are a lot of other 
people out there interested in DIY 
home surveillance. 

Whenever you’re making a 
project, don’t give up, advises 
Christoph. ^‘There are a few 
great tutorial websites available 
that describe how to get to a 
goal with pictures and step-by- 
step instructions.” 




The HD surveillance 
camera is much more 
adept than a regular 
CCTV cam. Here we are 
looking at a live feed 
from the camera inside 
a web browser 




PROJECTS 

WiFi cat feeder 


that dispense 
food to Bryan’s 
girlfriend’s 
two cats. 

PiPlanter 

If you have houseplants, then build a PiPlanter 
(esoLogic.com/?p= 665 ) to look after them. The 
PiPlanter monitors temperature, ambient light, 
humidity and soil humidity, and irrigates your plants 
accordingly. It even sends all the data to a MySQL 
database so you can check graphs on their growth. 



Create your own cat feeder to look after your feline 
friend whenever you’re not around. 

David Bryan’s 

cunning Cat ^ ^ 

Feeder f , 

(bit.ly/igGSJ4u) ^ 

is a purr-feet 

project to get flC 

your claws into ' 

(sorry!). The 

Raspberry Pi ^ 

controls servos 



Wildlife Cam Kit 

There’s no reason to automate your house and stop 
at the garden. If you want to take your Raspberry Pi 
outdoors, check out Naturebytes’ Wildlife Cam Kit 
(naturebytes.org). Place a Pi inside this weatherproof 
housing and it uses heat sensors to capture photos of 
the critters visiting your garden. 
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“• Directions are spoken out 
Loud and are confirmed 
using the pad 


^ \ The infrared eye sensor 

^ detects the motion of 

A the user's pupil 


MYRIJAM STOETZER 


frcjeclA 


SHOWCASE 


Myrijam Stoetzer is a 14-year-oLd maker 
from Duisburg, Germany. She has been 
competing in Jugend forscht, the German 
science competition for young people. 

zerozeroonezeroonezeroonezero. 

wordpress.com 


A windscreen wiper 
motor is connected 
to a small sD-printed 
wheel. This wheel 
drives the main 
wheelchair wheels 




tluich 

factA 

> The entire 
project took 
about 10-12 
months to 
complete 

The files have 
been released 
under the CC 
BY NC Licence 

> Originally, an 
Odroid was 
used instead of 
a Raspberry Pi 

A robot was 
used to test 
the software 

> The system 
can be used 
with any 
non-powered 
wheelchair 


EYE-CONTROLLED 

WHEELCHAIR 


Myrijam Stoetzer and Paul Foltin built an incredible eye-controlled 
wheelchair from 3D-printed parts, motors from a windscreen wiper, 
and a hacked webcam. Lucy Hattersley finds out all about it... 


yrijam Stoetzer and Paul 
Foltin, from Duisberg, 
Germany, have built 
this fantastic eye-controlled 
wheelchair. We caught up with 
Myrijam to talk about it. 

^^We did it because eye-tracking 
was so interesting,’^ says Myrijam, 
^^and then it occurred to us that we 
might steer something. 

^^While looking at different 
ways to build an eye tracker, 
we stumbled upon the Eyewriter 
project (eyewriter.org) from 
graffiti artist Tony Quan. ” 


Tony suffers from ALS 
(amyotrophic lateral sclerosis) and 
can only move his eyes. ^‘Tony was 
isolated for seven years before his 
friends helped him to paint and 
draw again using an eye tracker,” 
Myrijam tells us. ^^We wanted 
to help people like him be able 
to move again, because it is so 
horrible to imagine you couldn’t 
move any more.” 

Tracking ayes 

The eye tracker is a webcam 
modified to use infrared light and 


mounted on the frame of safety 
glasses. replaced the infrared 
blocking filter with a piece of 
analogue film that blocks nearly 
everything but infrared light,” 
explains Myrijam, ^hthen] we 
soldered in two infrared SMD 
LEDs in exchange for the white 
LEDs. This way, the eye will be 
illuminated by IR light, and the 
pupil reflects it back.” 

The camera is mounted 
inside a custom 3D-printed 
case and attached to the safety 
glasses frame. 
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EYE CONTROLLED WHEELCHAIR 


frqecb 



Pupil detection 

The Raspberry Pi 2 snaps images of the user’s eye from 
the IR camera at a rate of io-i2fps. A series of filters 
are applied to each image, increasing the contrast 
and making the pupil more easily identifiable. OpenCV 
software is used to map the coordinates of the pupil. 


Motor control 

The wheelchair is controlled by motors salvaged from a 
windscreen wiper unit. These are connected directly to 
the wheel on the wheelchair using a custom sD-printed 
profile (designed to match the wheels of the chair). 


>STEP-01 


Above A windscreen wiper motor is connected to a small sD-printed wheel. This small 
wheel drives the main wheelchair wheels 


Infrared camera 

The eye tracker consists of a webcam modified to use 
infrared (IR) light. The IR blocking filter is removed, and 
a film is used to block everything but IR light. IR LEDs 
replace the standard LEDs. A sD-printed case is used 
to mount the device on safety glasses. 


^^The camera films the eye, and the 
software extracts the position of the 
pupil and checks if it is within the 
range of four areas corresponding to 
the four movements,^’ says Myrijam. 

In the current version, the 
command is read out to the user 
via speech synthesis, and it has 
to be confirmed. Then the motors 
are switched on, depending on the 
direction. When the wheelchair 
is moving, infrared rangefinders 
check for obstacles in the path. 


>STERi02 


>STEP-03 


coordinates of the pupil that has 
been filtered out so far: this was 
the biggest breakthrough.^^ 

The wheels are powered by 
windscreen wiper motors rescued 
from the scrapyard. ^^We wanted 
to keep it possible so everybody 
can simply rebuild it on their 
own,’^ Myrijam tells us. These 
motors are connected to the 
wheelchair wheels using a small 
3 D-printed wheel contoured to fit 
around the tyre. 


Our biggest achievement was 
getting the tracker to find the 
coordinates of the pupil 


Raspberry Pi-powered 

The Raspberry Pi is used to capture 
images from the webcam, and 
OpenCV (opencv.org) is used 
for image manipulation. ^^The 
software captures images from 
the webcam with a frame rate 
of 10-12 fps,’’ says Myrijam. 

The image is converted to 
greyscale, before being blurred 
and converted to black and white. 
^^OpenCV offers a great filter that 
calculates the centre of gravity 
of a given shape, she explains. 
^^We use this function to get the 


It was a challenging project: 

^ht was very difficult to work on 
the code because this is our first 
time of leaving Lego Mindstorms 
behind,^’ says Myrijam. ^^Our 
biggest achievement was getting 
the tracker to find the coordinates 
of the pupil. After that, we knew 
it was possible. 1 learned to do 
3 D design, 3 D printing, Linux, 
Python, and image processing. 

It was amazing to see that you 
can integrate computer vision 
into your projects and combine 
that with physical computing. 
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The Raspberry Pi is 
kept on the belt of a 
costume, as it won’t fit 
properly into the case 


The main parts fit into a 
SD-printed case that 
clips over your arm 


An IT worker for an MSP company, 
Jesse has very little experience with 
making in this way, but is very good 
at researching. 

imgur.com/a/LFaPP 


Traecb 


SHOWCASE 


JESSE ROE 


A combination of a 3.5 LCD 
screen and convex glass creates 
an authentic look for the Pip-Boy 


‘Quick 

facti 

Jesse 
completed 
the project 
between 
October and 
Christmas 2014 

> There are still 
a few buttons 
to add, but it’s 
functionally 
complete 

Fallout 3 and 
New Vegas are 
his favourite 
Fallout games 

Jesse now 
wants to make 
a robot tank 
army with Pis 

The cast for 
the case was 
from Nakamura 
Shop, and the 
RasPipBoy Ul 
by Neal Corbett 


RASPBERRY 

PIP-BOY 3000A 


Survive the radioactive wastelands or a cloudy day in town 
with a custom-made, wrist-worn computer 


O he Pip-Boy from the 
video games is 
quite an iconic piece of 
kit these days. The fictional wrist 
computer’s functionality may 
be less amazing now than it was 
when the series debuted in the 
1990S, but the retro-futuristic 
look has kept it in certain corners 
of pop culture. Now, thanks to the 
reignition of interest in the Fallout 
franchise, the rise of makers, 
and the exploding popularity 
of cosplaying, every so often 
a new, home-made version of 
the Pip-Boy will turn up online 


and go a bit viral. Even with the 
impending release of a special- 
edition version of Fallout 4 with 
an official Pip-Boy, people are 
still making their own versions, 
like Jesse Roe. 

^‘The project was an attempt to 
make a fully functional Pip-Boy 
3000A. Not something to stick a 
phone in, but an actual working 
device,” Jesse tells us, referencing 
the official Pip-Boy which will 
require a smartphone. 

Having never found a perfect 
use for his Raspberry Pi, Jesse 
decided to use it for this project 


he was making for a friend. Using 
a 3D-printed case that he modified 
himself, the build wasn’t simple. 

worked on this probably 
about 70 hours total, with a lot 
of that being just research,” Jesse 
explains about his build process. 
^‘There was a lot of stuff out there 
on making a Pip-Boy, where to get 
the cast from, materials, etc. The 
main piece to get was the Pip-Boy 
cast itself, which 1 ordered from 
Nakamura Shop on Shapeways. 

^^Once it was in, we sanded it 
down and used model paint for 
the base with a darker green. 
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RASPBERRY PIP-BOY 3000A 


frqecb 



USE A CUSTOM PIP-BOY 


•mi immmn rmait ««„_ 
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Set it up 

You will need to get into a full Vault- 
dwelling outfit with a belt to house the 
Raspberry Pi. so that you can plug the 
Pip-Boy screen into it, and the Pi into 
some power. 


Boot It up 

You can enjoy the custom bootup 
messages, perfect for when you’re 
cosplaying and making your way to a 
convention floor to show off your fully 
functioning Pip-Boy. 


Show It off 

The custom interface, available from 
bitbucket.org/seLectnone/raspipboy. 
has many functions you can show to 
people who are interested: GPS, VATS 
simulator, and a Wi-Fi strength monitor. 


We detailed it up with scratches 
and other abrasions to look like 
a used model. 1 knew the suit as 
a whole needed to be separated. 
Too many people are so close to 
having a working Pip-Boy and 
get stuck when they say they 
canh fit everything in there! 1 
took a mechanics jumpsuit and 
put the 101 logo on the back as 


The hardest and almost final 
part of the build was the screen. 

1 ended up using a 3.5" TFT from 
Adafruit. The way the top bezel 
comes down and how you have to 
mount the screen means laying it 
down on something that covers 
all, for lips behind the bezel. 

Then after that, 1 had to lay 
a piece of glass on top of the 




1 worked on this probably 
about 70 hours total, with a 
lot of that being just research 


II 


well as other details. . . 1 used an 
old army surplus belt with lots 
of compartments for a part of 
the suit as well, and put a hole in 
the suit so all the wiring could go 
from the belt, up the back, and 
to the Pip-Boy. 

^^Next was getting the Pip-Boy 
to boot into the slightly tweaked 
on startup, which was 
fairly simple. 1 ended up editing 
the code to have a different 
startup message for the ^BIOS’ 
and whatnot, to make it more 
complete, but 1 didnh mess with 
the software too much. 


screen and glue it very lightly 
(but not too lightly) around the 
screen. Any mistake and you 
have to get a new screen because 
either you’re going to glue it down 
off-centre or youTl put too much 
on the screen.” 

Since Jesse hadn’t done 
much programming before, 
the modifications and setting 
up were a little tricky for him, 
but as you can see, in the end 
he managed to complete the 
project and walk around with 
a sweet Raspberry Pi-powered 
wrist computer. 
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DAVE YOUNG 

Dave is an electrical engineer and 
owner of Young Circuit Designs. He 
works with organisations in the energy 
and low-power consumer industry. 

youngcircuitdesigns.com 


— • When the Raspberry Pi 

detects a break in the laser, 
it captures a photo and plays 
an audio sound 


• The laser projects a beam 
of light to the mirror on the 
block of wood 


frcjeclA 


SHOWCASE 


r 




— • The laser beam is lined 
up to the Fresnel lens 
covering the photoresistor 


tluich 

factA 

> Raspberry 
Pi aside, the 
parts only cost 
around £15 

> The hardest 
part is getting 
the mirror to 
line up 

> It can play any 
audio file of 
your choosing 

A Fresnel lens 
is used to make 
it easier to line 
up the laser 

> It's based on an 
Arduino XBee 
shield project 


LASER DOG 
WATCHER 

Penny is a well-trained dog, thanks to her master’s Raspberry Pi- 
powered Laser Dog Watcher. Lucy Hattersley investigates... 


hen Dave Young, the 
owner of Young Circuit 
Designs, was training his 
dog Penny, he hit upon an idea. 
Why not turn a Raspberry Pi into a 
dog monitor that could issue voice 
commands when he’s not around? 

^^My dog Penny is a delightful 
girl,” says Dave. got her from 
the Denver Dumb Friends League 
[a local dog rescue] a few years ago. 
My wife and 1 were just going in 
to take a look. When 1 saw Penny, 

1 knew she was my dog. We walked 
out with her that afternoon. ” 


Penny is a very clever dog. She’s 
smart as a whip,” explains Dave, 
^^and is quite good at playing people 
like a fiddle. She uses her very 
slightly lazy eye to make the saddest 
face in the world. Especially when 
food is involved. She’s food crazy.” 

It took a long time to train Penny 
not to jump up on the counter and 
eat Dave’s food, didn’t want to 
use a shock collar,” he says, ^^and 
1 toyed with using some very high- 
pitched noise as a deterrent, but 
settled on an array of recordings 
of me reprimanding her.” 


The voice commands worked, 
but only when Dave was around 
to issue them. That’s when he 
hit upon the idea of using his 
Raspberry Pi to monitor Penny 
and issue spoken commands 
when he’s not around. 

The Laser Dog Watcher has 
a laser beam similar to security 
systems (650nm, 6mm, 3V, 5mW 
Mini Dot Diode), ^dt sends a laser 
out to a mirror and measures if it 
makes it back to a sensor. If the 
sensor can’t see the laser, there is 
a circuit that tells the Raspberry 
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LASER DOG WATCHER fr^ecb 



Make a noise 


MAKING THE 
DOG WATCHER 


The Raspberry Pi then plays one of three verbal 
commands (personally recorded by Dave). These 
are all variations of ‘no’ which encourage Penny 
to move down from the table. 


Laser tripwire 

A laser is recessed into the device and placed at one 


end of the table. The laser is aimed at a mirror at the 


other end of the table, and the laser beam is reflected 


into a photoresistor (back on the mam device). 


STEP 


02 


Pi that the laser beam has been 
broken. The Pi then takes a photo 
of the area near the sensor and 
plays an audio file of my voice 
saying one of a few things that 
1 use to reprimand her. 

recessed a photoresistor 
[Excelitas Tech VT935G] into the 
box to block out ambient light and 
put the system on one side of the 
counter, and a mirror on the other 
side. 1 aim the laser to go from the 
system, bounce off the mirror, 
and then come back to the sensor. 
When the laser is blocked, the 
photoresistor sees less light [and] 
changes its output voltage, which 


^^Think hard about the 
mechanical system,’’ advises 
Dave, ended up using a Fresnel 
lens to make it easier to aim the 
laser. The Fresnel lens allows for 
the laser to be directed at a larger 
target area. A photoresistor is a 
pretty small sensor, and accurately 
hitting it from a lo-foot total 
laser length is a real challenge. 

If the laser hits anywhere on the 
lens, it will send the light to the 
photoresistor sensor. 

^d also added some error 
correcting,” says Dave, ^‘so that 
it doesn’t continue until the laser 
beam connection is remade. That 


I The Pi then takes a photo of 
the area near the sensor and 
plays an audio file of my voice 


STEP 


03 


is fed into a digital input pin 
of the Pi.” 

Building a baser Dog Watcher 
wasn’t as easy as it sounds, ^d’d 
put it at medium to medium- 
hard difficulty,” says Dave. ^^The 
electrical circuit is easy, but creating 
a mechanical system that lines 
up nicely takes a bit of thought. ” 
Helpfully, for anyone wishing to 
replicate the project, Dave has 
placed all the design schematics 
on the Elementi4 community 
website (bit.ly/ij3pils). 


way, if she knocks the aim of the 
system off, it won’t continually 
play my voice over and over. ” 

The system is designed to cycle 
through three audio files of Dave 
saying ^no’ in a variety of ways, 
along with capturing a photograph 
of Penny. The laser tripwire could 
be put to a variety of different 
uses, though; it would benefit 
anything that responds to motion. 

Below Penny is mostly a good dog, but 
she can’t stop herself from jumping on 
counters and eating food 


When Pennyjumps up to the table, she blocks 
the laser. The photoresistor detects the change in 
light and sends a signal to the Raspberry Pi. It then 
captures a photograph. 


>STERr01 
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SHOWCASE 


PETER ROCA 


frcjeclA 


VP of technology, and Lead software 
developer, at a small company in 
Washington, DC. He has a degree 
in NeurobioLogy and has been 
coding for 15 years. 
peterroca.com 



BEDBOT 


An over-engineered alarm clock built into a bedside table that 
wakes you up with music. It’s also powered by a Raspberry Pi 


Normally sitting flush, this 
screen flips up during the 
alarm, revealing the buttons 
underneath to control it 


'Quick 

factA 


> The whole 
thing took Peter 
400 hours over 
six months 

It was Peter's 
first Raspberry 
Pi project 

ALL the source 
code is 
available for 
free on GitHub 

> Peter had never 
used Python 
before this 
project 

> When we 
asked him 
about it, he said 
“At Least it Looks 


® hen you think of an alarm 
clock, you probably get 
an image of a silver, 
analogue clock with bells on top. 
Thanks, television. No one really 
uses that any more, starting with 
the invention of clock radios and 
the Teasmade, and right up to 
smartphones acting as our alarm 
clock and morning newspaper. 
What’s the next step in the 
evolution of waking up in the 
morning? Well, it probably won’t 
be the Bedbot, but it’s really cool 
either way. 

The Bedbot is, according to 
its creator Peter, ^^My Daytime 
Initialization Assistant - a digital 
alarm clock/radio with a fancy 
wooden enclosure. It is a crude, 
over-engineered, expensive piece 
of hardware.” 

The idea came to him after being 
a little fed up with the kind of 
radio programming he was getting 
when he woke up in the morning 
(apparently a little later than most 
people), realised that 1 could 
use my new RPi to create a radio 
device that could bypass trivial 
things such as NPR’s morning 
program schedule.” 

The Raspberry Pi is built into a 
walnut and maple side table, with 
a little screen that flips up when 
the alarm starts the radio. From 
the images, you can see that the 
relatively small table has a lot of 
electronics packed into it. The table 
was also made by Peter. 
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BEDBOT 


frqecb 



Above The circuitry is quite complicated for what you could feasibly consider 
to be a simple function, but it makes it high-quality 


Started woodworking about 
four years ago in my free time/^ 
he tells us. really enjoy creating 
interactive systems which is why 
this project was so fun for me. 
Working in my shop is cathartic 
and it offsets the lethargy that 
working in an office inevitably 
encourages. 1 think a lot of 
software developers eventually 


^‘The only complicated part 
is how 1 designed the [Python] 
module system. Each major 
feature of Bedbot is considered a 
^module’ and has no dependencies 
on other modules, so that modules 
can be added or removed without 
breaking anything else... if it’s 
configured correctly, Bedbot 
will find the module and load 


PROGRAM YOUR 
TABLE ALARM 



Set your alarm 


As well as time, you need to tell BedBot what kind 
of wake up you want. Normal radio? Internet radio? 
Play from an MP3 player? The choice is yours. 




Each major feature of Bedbot is 
considered a 'module' and has no 
dependencies on other modules 




pick up some kind of hobby that 
requires using your hands for 
something other than typing.” 

The electronics comprise the Pi, 
WiFi and Adafruit PiTFT screen, 
along with a small OLED, USB 
audio cards and custom speaker 
system, servos for the screen to 
flip up, several buttons, and lots of 
other custom-built bits to the get 
the look and effect he wanted. 

Next came the programming, 
which wasn’t too complex. 


it automatically into the menu 
system. There are hooks to allow 
for modules to communicate 
with each other through a 
broadcast system. 1 designed it 
this way to allow for anyone to 
write their own module without 
having to dig into the code of the 
entire system.” 

The proof is in the pudding, as 
they say, so how well does it work? 

^^Well, 1 haven’t been late to 
work yet!” 



Ga ta sleep 

As humble writers about the Raspberry Pi. we can’t 
really tell you howto accomplish that. Big Bird taught 
us how to get to sleep, though; try him. 




Above The rear of the table gives away that this is more than just a bit of furniture. 
Sit it up against a wall to hide these parts away 


11:39 


INTERNET RADIO 

NPR (WAMU) 



The screen Lifts up when the alarm time comes 
around, and your selected audio starts playing. There 
is a snooze button for five minutes’ more kip. though. 
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feature starring the raspberry pi 



STARRING THE 

RASPBERRY PI 


Slowly but surely, the Raspberry Pi has been turning up in movies 
and TV shows. Simon Brew tracks its screen appearances to date... 


he lure of gazillions of dollars in product 
I placement revenue, or perhaps just swagging 
some free kit from the Apple Store, may lead 
you to think that nobody in the movies would be seen 
dead with anything less than a MacBook and some 
overpriced accessories. Heck, in the film Percy Jackson 
& The Olympians: The Lightning Thief, no longer could 
the mythical Medusa now be defeated be spotting her 
reflection in a sword and shield. An iPod, that’s what 
they needed. 


But could times be changing? Even movie and TV 
productions face austere times, and thus the days of 
every ten-year-old owning an array of top-end products 
from PC World may be coming to an end. Instead? The 
flexibility, quality, and affordability of the Raspberry Pi 
have led to it sneaking more and more onto screens, big 
and small. You don’t need us to tell you just what the 
Raspberry Pi can and can’t do. But will someone need to 
tell Hollywood? Let’s take a look. And remember that all 
these Pis were billable to their respective productions. . . 


COMPUTERS ON SCREEN 

It’s little secret that the depiction of technology in film 
and TV leaves something to be desired. Here are just 
a few of the common faux pas that slip through the 
net, which tend to irritate the most... 

When a character appears on the screen, 
a beeping noise of sorts has to be made. 

Switching the screen ofF tends to switch 
the computer ofF. 

Also, unplugging one computer stops 
a network hack. 

> Photo-enhancing software can enhance 
any photo on planet Earth. 


Complicated passwords can be cracked in a matter 
of minutes. In the case of the. er. all-time classic 
Swordfish, this can be achieved when the hacker 
in question is ’multitasking’. 

> They don’t crash. Ever. 

> Remote signals can be sent to individual 
components, in turn causing them to blow up. 

> Every teenager in America seems to own an Apple 
Mac. And can afFord all the accessories. And 
likes to angle it so the logo is pointed towards, 
coincidentally, wherever the camera happens 

to be pointing. Lucky, that. 
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In brief: 

Remake of much-loved action movie. Not many 
people seem to be looking forward to it, judging by 
86% of words written about it on the internet so far. 

What does the Pi do? 

Blows stuff up. Er, that seems to be it. But as the 
film isnb out yet, it may yet turn out to be a major 
supporting character. You never know. 

The details: 

Nothing cheers people up like a beloved film getting 
the Hollywood remake treatment. 

A lie, clearly, as a quick look around internet 
message boards will testify. Theyhe remaking Point 
Break? And none of the original cast will be anywhere 
near it? As Edmund Blackadder once mused, think 
the phrase rhymes with clucking belEE 
The new Point Break movie doesnh arrive until 
Christmas 2015, so let’s err on the side of optimistic 
and suggest that it’s going to be an Oscar-winning 
classic. But already, in the trailer for the film, we can 
see that the Raspberry Pi is taking on a significant 
supporting role. 


It’s good to see that Point Break is tackling the current 
lack of quality movie villains by, well, sort of taking 
their place. So, from what we can make out, the idea 
is that you attach your Pi to some explosives, and then 
all you need is one of those wonderful movie products 
where you have to press one of two buttons to blow 
seven shades out of everything in the immediate 
vicinity. We’ve never hung around long enough 
to find out what the other button does. 

We saw this using boring old technology in that other 
awards-attracting masterpiece. Die Hard 4.0, where the 
wheeze that time was basically to have an exploding 
hard drive. Those of us of a certain vintage may 
remember times when the humble hard drive did have 
less of a reliable quality to it, but attacking computers 
in a manner that leaves Bruce Willis diving around your 
place of residence? It’s a bit of a stretch. 

Given that just a few minutes of Point Break have 
thus far been released, we’ll have to assume that 
the trailer has happily glossed over the bit where 
the antagonists excitedly take delivery of their Pi 
and customise it a bit. But we’re sure that’s going 
to be in the final cut of the film. It’d be a startling 
omission otherwise. 




I 
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feature 



In brief: 

A TV series set in post-apocalyptic times, where the 
world is on the receiving end of a permanent electrical 
power blackout. 

What does the Pi do? 

It Still works! Even though pretty much nothing else 
does. That, friends, is value for money. 

The detoiis: 

The idea behind the TV series Revolution, which 
ran for two seasons between 2012 and 2014, is that 
electricity’s days are numbered. Thanks to one of 
those pesky apocalypses that science fiction likes 
to foist on us from time to time, all electrical devices 
on planet Earth are done for. A permanent electrical 
blackout shrouds the world. 

The result of all this is an intriguing television show 
about how humans might cope without Candy Crush 
Saga, mean tweets, and cat GlEs. 

But what’s this? A working Raspberry Pi snuck in 
there? How could that happen? That’s the beauty of 



such a low-power device, clearly. Even when there’s 
no electricity, the damn thing still works! 

Actually, that’s not quite true. As Revolution 
progresses with its intriguing premise, it starts to 
cheat a bit. Small pockets of power are generated, 
and so, with that in mind, electronics are sought 
and utilised. Thus, in the episode The Longest Day, 
which is the 17th instalment of me first season, 
the character of Aaron is trying to get an old Mac up 
and running, but actually - as you can see from the 
screenshot we lovingly grabbed with our electricity- 
free supercomputer - something rather familiar, 
and more affordable, has crept into shot. 

Good news, though: the device is being brought 
into being with the intention of saving someone’s 
life. So already in this feature, we’ve gone from a 
Raspberry Pi being a tool of villainy to one employed 
by heroes. That’s far more like it. 

The idea is that apparently early nanotechnology 
is being assembled, so that it can take hold of energy 
from someone’s capsule and knit together the 
wounds of a dying woman. Naturally enough, if it 
doesn’t go to plan, then we’re back where we were 
with Point Break. We don’t want to give too many 
spoilers away here, but the Raspberry Pi at the very 
least survives. So that’s something. 

It’s hard to judge just how realistic an application 
for the Pi this actually is, as Revolution is set in the 
year 2027, and a lot can happen in the next 12 years. 
Rest assured, when a $35 piece of hardware starts 
performing life-saving surgery, it’ll make more than 
the cover of this magazine. Especially if it saves a 
Kardashian hot or something. 
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person of 

INTEREST 


In brief: 

A still-running American TV drama series, about 
a man who seems to have seen Minority Report and 
therefore invents a system that can help prevent 
crimes before they happen. Thus far, Tom Cruise 
has not appeared. 

What does the Pi do? 

Brings internet to that scary bloke from Lost. Having 
seen Lost, we would not refuse his request. 

The details: 

Persons Of Interest is a bit of a bumpy series, and 
certainly the first season of the show did it few 
favours. But like many American dramas, it has 
matured, become more interesting, and tried to 
placate people like ourselves by inserting agreeable 
technology in from time to time. We’re easily 
bought like that. 

The show has enjoyed four seasons so far, and the 
fifth is in production. Reports suggest that this might 
be the last one, so the production team are running 
out of chances to squeeze a further Raspberry Pi in 
there somewhere, as is their constitutional duty. 

But at least they’ve already managed one. 

Okay, so it’s not a starring role, but a fresh 
Hollywood agent should soon sort that out. And at 
least the Pi gets to sit in the centre of a shot. For now 
then, Harold Finch - played by Michael Emerson - 
has shown his technical taste by using a Pi in the 
season three premiere of the show. Here he is, with 
a Pi in an Adafruit case attached to the back of his 
laptop. Because sometimes, you can’t trust a wireless 
hotspot, right? Better to invest a few quid and bring 
some cables out with you. 


THE ANT-MAN 
TINY TECH CHALLENGE 

f-tQMe MDHE IRPPl-Y 

MMifa 


□ 

IIITHEHIiESJUL>l7 

^?CRO-TE CH C hallenge; 

§§ mnntRY V/SA 

While Marvel’s latest superhero opus, Ant-Man, 
doesn’t actually feature a Raspberry Pi itself, the 
marketing boffins behind it were keen to harness 
the idea of tiny technology for a tie-in promotion. 
Given that the film has banked over $300m at the 
time of writing, it seemed to work, too. That, and all 
the posters over the side of buses and stuff. 

In conjunction with Dolby, Marvel Studios, 

Disney, and Visa Signature, the Raspberry Pi- 
backed Ant-Man Micro-Tech Challenge was 
launched. It was an American competition, aimed 
at girls aged 14-18. The objective? To make a 
DIY project using at least one readily available 
micro-technology component. 

The winners were announced at the end of June. 
Allison White came up with a water-limiter for 
shower heads, to alert people that they were using 
too much water. Anna Nixon turned a teddy bear 
into an interactive character, complete with face 
detection, a GUI, and voice recognition. The aim is 
to add health detection features in the future. 

Ashita Patel made a robotic arm that draws 
images created on a computer, while Elizabeth 
Almasy made a bubble maker in the shape 
of an octopus! 

The winners all went to see the Ant-Man movie at 
its premiere, and got to spend time with the people 
who make theme park rides at Disneyland. It made 
us wish that we’d submitted our Candy Crush Saga- 
Destroying Nano Bots (TM) in time. 

Full details of the challenge can be found here: 
www.ant-manchallenge.com/winners.php 


Oddly, it’s a practical use for the Raspberry Pi, 
which goes against the way computers tend to be 
dramatised on screen. So even though it’s implicit 
use, and the Pi isn’t arresting a terrorist or the like, 
we can but salute it. 

Relatively realistic tech usage in Hollywood 
productions? At this rate, they’ll be making funny 
Adam Sandler films again soon. Or is that where we 
get too far-fetched? 
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STARRING THE RASPBERRY PI 



In brief: 

The CSl show that’s not set in Las Vegas, Miami, New 
York, London, Los Angeles, or Bridlington. The one 
that is also laughed at a lot by people who have used 
computers for more than ten minutes. 

What does the Pi do? 

Potentially brings down the entire world. Messes 
around with lift doors. Gets a price increase. 

The detoiis: 

The never-ending CSl television franchise has of 
late decided to turn its documentary-esque levels 
of accuracy and focus (go with us on this) towards 
cybercrime. Naturally, therefore, they all use movie- 
style computers that make a little noise whenever a 
single digit of text appears on the screen, but let’s gloss 
over that for the minute. In fact, if you’re looking for 
realism, it’s probably best to gloss over most of the 
show. But that’s concessions to TV drama for you. 

For there are atrocities to battle! And, wouldn’t 
you know it, the Raspberry Pi is sat near the heart 
of them. In this case, it’s a roller-coaster crash with 
assorted fatalities, and the team soon realise that a 




computer had been hacked to switch off the necessary 
safeguards. Final Destination 3 ensues. Then, we learn 
that it’s being used to help control subway trains, too. 
By the end, we wouldn’t be surprised if they’d said it 
was being used to put the wrong flavouring in crisps. 

Don’t worry, though, as there’s a non-stereotypical 
bearded, slightly overweight nerd on hand to get 
to the bottom of things. He helpfully points out 
to Patricia Arquette’s boss lady that these devices 
^‘can be found online for about $50”, and then 
demonstrates how one can be used to comedically 
open and close lift doors while people are still in it. 
^‘Anyone can hack in,” he warns, sagely, standing 
next to his non-stereotypical messy desk. 

So, can all this be done? Can’t say we’ve tried, to be 
honest, and, just for the sake of clarity, we have no 
intention of doing so. Can a Raspberry Pi be used to 
control the operations of things like doors, and, er, 
roller coasters? Well, you know the answer to that. 

We look forward to future episodes of CSl: Cyber, 
though, given that it’s got a second season on the way. 
Expect the Raspberry Pi to be at the heart of further 
villainy, and inaccurate price projects. After all, $50? 
They should shop around a bit. . . 
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CHARLIE 

BROOKER'S 

ELECTION 

WIPE- 

In brief ^ 

Ahead of the UK gene^ftection, Charlie Brooker and 
a chum or two dissect^tl^campaign, and fitted in a 
Raspberry Pi joke. 

What does the Pi do? 

It allows Charlie Brooker and Philomena Cunk to talk 
to each other, if, ahem, you take it at face value. But 
mainly, it lets them poke fun at election coverage. 

The details: ^ 

Via his series of Weekly Wipe programmes on the 
BBC, Charlie Brooker has regularly taken a spear to 
the conventions of news reporting, and exposed its 
limitations. He does it with cutting humour, too. 

We like him. 



I It's as if he's making a joke about people 
not being able to wrap their head around 
technology or something 


II 


But then Brooker cut his teeth on computer 
magazines, and for some time was a writer on the 
long-lost PC Zone, a British computer magazine 
we still miss. For his Election Wipe programme, 
broadcast ahead of, as you might expect, the 2015 
UK General Election, he turned his gaze to the most 



^^unpredictable’^ election that the British Isles had 
faced since, er, the last one. Naturally enough, his 
satirical dart-throwing was accurate. 

So where does the Raspberry Pi fit in? 

As a punchline of a gag, as it happens. 

It pops in at the end of a sequence where 
^Philomena Cunk’ is trying to make head or tail of 
the assorted of graphics and data that surround an 
election campaign. All the gubbins, basically, that 
you get from experts ahead of an election, who prove 
to be entirely incorrect, and then turn up a few years 
later to do it all again. As Cunk switches back to 
Brooker, we see that he is holding a Pi, and using 
it to talk into. It’s as if he’s making a joke about 
people not being able to wrap their head around 
technology or something. 

This is the bit where it’s important to recall that 
Brooker more than knows his way around technology. 
The joke doesn’t work so well otherwise. So chortle 
along and just remember that he’s one of us. He’s just 
paid a lot more. 
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Tutorial , walkthrough 


EVERYDAY 

ENGINEERING 


PART? 




SIMON MONK 

Simon Monk is the author of 
the Raspberry Pi Cookbook and 
Programming the Raspberry Pi: Getting 
Started with Python, among others. 


simonmonk.org 


monkmakes.com 



FRIDGE MONITOR 


'You’U 

fleed 

> Photoresistor 
(almost any one 
will work for 
this project) 

> 2x female- 
to-female 
Jumper wires 

> USB Wi-Fi 
adaptor (unless 
your fridge has 
an Ethernet 
socket nearby) 


Solve real-world electronic and engineering problems with your Raspberry Pi 
and the help of renowned technology hacker and author, Simon Monk 


O he house is infested with cheese fairies who 

raid the fridge at all times of day and consume 
considerable quantities of tasty cheese. In this 
project, any fridge-door-opening activity will result 
in a notification email - or, if you prefer, a tweet or 
Facebook update - telling you the time that the fridge 
door was opened. 

This may seem a somewhat trivial example, but it 
really serves to show just how easy it is to hook up a 
sensor that will cause your Raspberry Pi to notify you 
of events in a variety of ways using the If This Then 
That framework. 


As youTl see from the list of required components 
on the left, this project uses a photoresistor connected 
to the Raspberry Pi GPIO header using a pair of 
female-to-female jumper wires. 

Detecting Darkness 

Unlike an Arduino, for example, a Raspberry Pi 
does not have analogue inputs that can measure a 
voltage. It does, however, have digital inputs; if the 
voltage at a digital input exceeds about 1.65V (half of 
3.3V), then the input is read by the Raspberry Pi as 
HIGH, otherwise it is counted as LOW. So, although 
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FRIDGE MONITOR 


Tutorial 



Above Fridge monitor 


you can’t use a photoresistor with a Raspberry Pi to 
give a measurement of the light level (not without 
a few extra components anyway), you can use a 
photoresistor to tell if it’s dark or light. 

The digital input pin (GPIO pin i8) has its internal 
pull-up resistor enabled. So, while the pull-up 
resistor is trying to pull pin i8 HIGH, the photoresistor 
will try to pull it low. They are in a of tug-of-war and 
if the pull-up resistor is winning, the input will be 
HIGH; if the photoresistor is winning, it will be LOW. 

The more light falling on a photoresistor, the lower 
the resistance (the stronger it pulls pin i8 towards 
oV). Typically, a photoresistor will have a resistance 
of a few hundred to a few thousand ohms when it’s in 
the light. If you make a photoresistor really dark (say 
inside a fridge), then its resistance rises to several 
mega-ohms (millions of ohms). At this point, the 
built-in pull-up resistor (50 to 100 kilo-ohms) will 
be easily winning and the input will be HIGH. 


If This Then That(IFTTT) 

IFTTT is a web service that allows you to set up 
triggers that then cause an action. For example, you 
could create an IFTTT ^Recipe’ that sends you an email 


BUILDING THE PROJECT 

This is a really easy project to make. There is no soldering to be done and 
Just two wires to connect up. In fact, most of the work is in setting up IFTTT. 



; Create 0 Rtdps 


if thenthat 


V Compiffte Trigger Fields 
I * ■wibi Jflquwt 


>STEP-01 

Connect the photoresistor 

Connect the two leads of the 
photoresistor to the female-to- 
female Jumper wires. It does not 
matter which way around the 
photoresistor is connected. The 
other ends of the Jumper wires are 
connected to GND and GPIO 18 of 
the Raspberry Pi. 

If the photoresistor leads are 
a bit loose in the Jumper wire 
sockets, bend a little zigzag into 
them so that they stay firmly in 
the sockets. If you are worried 
about the legs of the photoresistor 
touching each other, you can 
shorten them with snips. 

>STEP-02 

Start a new recipe in IFTTT 

If you don’t have one already, 
create an account on IFTTT 
(ifttt.com). Then click on the 
‘Create a Recipe’ button. 

>STEP-03 

Create a Maker 
Channel trigger 

Click on the IF part of the new 
recipe and search for the Maker 
Channel in the list of channel 
icons that are shown. Select 
the only trigger option available 
(Receive a web request) and 
enter the text ‘fridge.alert’ into 
the Event Name field. 


(action) whenever someone mentions you on Twitter 
(trigger). As well as actions and triggers from all sorts 
of social media and email services, IFTTT can be set 
up to work with physical events, such as your fridge 
door opening. 

The way this works is that the Raspberry Pi sends 
a web request to IFTTT as a trigger and then IFTTT 
performs whatever action you have specified for it. 

In this case, that is sending an email. 

The various channels available to IFTTT often 
require their own logins, so IFTTT will, from time to 
time, ask you to enter a user name and password for 
that channel. 


» 
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WALKTHROUGH 




Choose Actsort Channel 

1 tr 

Choose on action 

email 

Now w© com© to th© THAT part 

B B M 

of IFTTT. So, click on Action, 

choos© th© Email action channel 

and then select ‘Send me 

an email. 



Q Complete Actloin Fields 
Sandofie an enuU 
□ Sul^Kt 

Tb« ttdg* dtNK wii cifHnad 



Tha tridgi dur yhi cqwwd m HOcimnKlAllKiMH 


>STEP-05 

Complete the action fields 

You now need to fill in the fields. 
The ‘subject’ field will become the 
email subject while the body field 
will contain the text of the email. 
Notice the use of the special 
names contained between {{ and 
}}. These are called 'ingredients’ 
and allow you to customise the 
text. In this case, the ‘OccuredAt’ is 
a timestamp for when the trigger 
event happened. 


My Redp^ 



If^ I thenQ 


if f:'/an[ ■ iefg*.alar'. ** — 
amad at imMtihdt^rnallxorn 


0 O := 




>STEP“06 

Complete the recipe 

After you have completed 
the action, you will return to a 
summary of the recipe. Click 
the ‘Create a Recipe’ button to 
actually create the recipe and 
make it active. 


Maker Channel 


V 


paiMioil DIV prcfKb. Wilh Mifta', yau i 


>STEP-07 

Find your secret key 

Bad things could happen if Just 
anyone were allowed to trigger 
emails to be sent using IFTTT. 

So, when the web request is sent 
from Python to trigger the email, 
it must be accompanied by a 
secret key. To find that key, click 
on the Channels tab at the top 
of the IFTTT webpage and then 
find the Maker Channel. In a little 
while, you are going to need to 
paste the secret key into your 
Python program. 


Now that the hardware side of the project is 
complete, and IFTTT has been configured, we need 
to look at the Python program that will send the web 
requests to trigger IFTTT. 

Download the Python program for this project using 
the following commands: 

cd /home/pi 

git clone https://github.com/simonmonk/ 
pi_magazine.git 



This command will actually bring down the code for 
all the projects in the author’s MagPi series, so if you 
have already issued this command for one of the earlier 
articles, change directory to pi_magazine and run the 
following command to update your directory with this 
project (o7_fridge_monitor): 

git pull 

How the code works 

The Python code for this fridge monitor project is 
pretty straightforward. If you are interested in how 
the code works, load it up into a text editor while we 
go through it. 

The first section of code includes all of the libraries 
you need. This includes the RPi.GPIO library that 
is needed to interface with the photoresistor and 
the urllib2 library responsible for sending the web 
request to IFTTT. 

The next section contains variables that are used 
to configure the program. EVENT must match the 
text that you specified as the Event Name when you 
created the trigger. You need to replace the value 
of the KEY variable with your key that you found 
in step 7 (see box on left). 

The function send_event will be called by the main 
part of the program when IFTTT needs to be notified. 
The response from the web request is printed out, 
just to provide useful information while you are 
getting the project working. 

The main program loop is contained in a try : 
finally: block, so that the GPIO pins will be tidied 
up when the program exits. The main loop inside 
while T rue : will keep running until you quit the 
program with CTRL+C. It checks to see if LIGHT_PIN 
is 0, indicating that the fridge door has been opened. 
When this happens, send_event is called. 

To prevent a whole series of events being sent 
every time the fridge door is opened, two measures 
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FRIDGE MONITOR 



are taken. First, a while loop does nothing while the 
door is still open, to prevent repeat triggering every 
time around the outer loop. Second, when the door 
is finally shut, the program sleeps for a minute to 
prevent any further triggerings within that minute. 

Using your fridge monitor 

If you want to make your project a bit more 
permanent, you could tape the photoresistor 
to the top-inside surface of the fridge, rather 
than just letting it dangle like we did. 

Before running the Python program, you can 
test out your recipe from the command line using 

I You might like 
to experiment by 
editing the recipe 

the wget utility. Type the following command 
into LXTerminal. You will need to substitute your 
secret key. 

curl https://maker.ifttt.com/ 
trigger/f ridge_alert/with/key/ 
cyR3vPNFlP9K32W4NZB9cd 

Youhl then see the message, ^Congratulations! 
YouVe fired the fridge_alert eventh 
Check your inbox and you should see an email 
from IFTTT. If anything went wrong, you should get 
an error message in place of the congratulations. 

You can also see the logs for your recipe on the IFTTT 
website by selecting the recipe and then clicking the 
icon that looks like a series of bullet points. 

Start the fridge monitor program with the 
following command: 
sudo python fridge_monitor.py 
IFTTT is a very powerful system, so you might like 
to experiment by editing the recipe and changing 
the action so that it tweets or changes your Facebook 
status instead of sending an email. 

Having a keyboard, mouse, and monitor attached 
to your fridge-mounted Pi is fine during testing, but 
really, it would be better to have the fridge monitor 


If 


fndge-nwnitor^y 

'Igngu^ 

>PYTHON 


import time 

DOWNLOAD: 

Github.com/ 


import RPi.GPIO as GPIO 

simonmonk/ 


import urllib2 

pLmagazine/ 

tree/master/ 


LIGHT_PIN =18 # photoresistor pin 

07_fi'idge_monitor 



EVENT = ^fridge_alert^ 

BASE_URL = ^https: //maker. ifttt.com/trigger/^ 
KEY = "cyR3vPNFlP9K32W4NZB9cd" 


# Configure the GPIO pin 
GPIO. setmode(GPI0. BCM) 

GPIO.setup(LIGHT_PIN, GPIO. IN, pull_up_down=GPIO. PUD_UP) 

def send_event() : 

response = urllib2.urlopen( 

BASE_URL + EVENT + Vwith/key/-’ + KEY) 
print(response.read()) 

try: 

while True: 

if GPIO. input (LIGHT_PIN) == 0: 

# Its light (door open) 
send_event() 

# Do nothing until the doior is closed again 
while GPIO.input(LIGHT_PIN) == 0: 

time. sleep(0.1) 

# Do nothing for a further minute anyway 
print (‘^‘^Wa it a minute^^ 
time.sleep(60) 

print("Monitoring again^^ 

finally: 

print( ‘^Cleaning up GPIO-’) 

GPIO.cleanupO 


program start automatically when the Raspberry Pi 
first starts up. To do this, run the following command 
to make the program executable. 

sudo chmod +x fridge_monitor.py 

Then, edit the file /etc/rc. local with the command: 

sudo nano /etc/rc. local 

Add the following line after the first block of 
comment lines that begin with #. 

sudo /home/pi/pi_magazine/07_f ridge_ 
monitor/fridge_monitor.py & 

Restart your Raspberry Pi and this time the fridge 
monitor program should start up automatically. 


NEXT MONTH 

In the next project in this series, we'LL 
create a garden waterer that will keep 
your plants alive while you go on holiday 
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Tutorial 


STEP BY STEP 


Modern gaming isn’t the first thing 
that springs to mind when you look 
at a Raspberry Pi. but you can do it! 



RICHARD WATERWORTH 

Richard makes technology videos 
on the internet and blogs about 
technology including the Raspberry Pi. 

richardtech.net 



The Pi will be streaming your 
games from your PC over 
your home network 


STREAM STEAM 
GAMES TO YOUR 
RASPBERRY PI 


^ouU 

tieed 

> Nvidia GTX 650 
graphics card 
or higher 

> GeForce 
Experience 

geforce.com/ 

geforce- 

experience 

> Raspbian 

> Internet 
connection 


r 


The Raspberry Pi can do a lot of things, but maybe you didn’t know 
that you can use it to stream your favourite games from your PC 


O ometimes it’s just not convenient to play the 
latest PC games on your clunky, noisy PC. It’s 
either tucked in the corner of the bedroom 
or under the stairs, right where it’s bound to disturb 
other people from the moment you press Start to play. 

Never fear, though, because it’s possible to play 
your favourite triple-A PC games from the comfort 
of any TV in the house using nothing more than a 
suitable graphics card, a Raspberry Pi and this guide... 

>STEP-01 

Install dependencies 

Before we begin, you will need to make sure that 
you have all the dependencies installed; typically, 
these will already be installed with Raspbian. The 
dependencies are essential for Moonlight, the 


application we are using on the Pi to stream, to 
work. To make sure you have all of the dependencies 
installed, use the following command: 

sudo apt-get install libopus0 libasound2 
libudev0 libavahi-clientS libcurl3 libevdev2 

Once this has been done, we can install Moonlight, 
after we have configured the sound. 

>STEP-02 

Configuring sound 

To make sure that we have sound coming out of the 
HDMl port, we need to edit the boot configuration file 
and add a line of text. To edit the boot configuration 
file, you will need to enter the following command: 
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Above Setting up game-streaming is as simple as typing 
in a selection of console commands 


sudo nano /boot/config.txt 

This will then bring up the Pi’s nano text editor. 
You will want to go to the end of the file and enter 
this line: 


ipconfig 

This will obtain the IP address of your PC. If there is 
a big list, your IP address should begin with Y92.168’. 

Now we can pair Moonlight with the computer by 
using the following command on the Pi: 

moonlight pair YOUR-IP 

...replacing YOUR-IP with the IP address of your 
Windows PC. Once you’ve entered this command, a 
PIN code will appear in the terminal, which you will 
need to enter into the GeForce Experience box that 
pops up on your Windows PC. 


USING 
ETHERNET 
VS WI-FI 

Using Ethernet 
will allow you 
to get a better 
frame rate 
and resolution 
compared to 
using Wi-Fi. 


There are many options 
that can be added to the 


hdmi drive=2 


moonlight command 


Once this is done, the sound should be ready to go! 

>STEP-03 

Downloading and installing Moonlight 

Now we’re getting somewhere! But just before we can 
download Moonlight, we need to add its source to the 
Raspberry Pi’s sources list. To edit the sources list, 
type in this command: 

sudo nano /etc/apt/sources. list 

This should open up the sources list in the nano text 
editor. Now all we need to do is add the following line 
to our sources list to add Moonlight’s source: 

deb http : //archive . itimmer . nl/raspbian/ 
moonlight wheezy main 

Once this has been done, we can save and quit the 
file, and then check for updates on the Pi: 

sudo apt-get update 


>STEP-05 

streaming with Mooniight 

Streaming with Moonlight is very simple; all you need 
to do is type into the terminal: 

moonlight stream YOUR-IP 

Steam Big Picture mode will automatically pop up. By 
default, the stream will be 720p at 6ofps, but we’ve 
had better luck on our network at Bofps. There are 
many options that can be added to the command. To 
stream at Bofps, for instance, you would enter: 

moonlight stream -30fps YOUR-IP 

You can find all the options for the moonlight 
command at bit.ly/moonlight-options. These include 
io8op streaming, changing bitrates, resolutions 
and much more! 

Below Play some of the hottest games on your Pi, by streaming 
them from your PC’s Steam games library 


USE A 

CONTROLLER 

Moonlight 
does support 
controllers, so 
you can game 
as if the Pi were 
a console. Sadly, 
we didn't have 
much Luck with 
our controller, 
but yours may 
be more of a 
success. 


w 


Once this command has been run, we can finally 
install Moonlight! 

sudo apt-get install moonlight-embedded 

So, now we’ve finally managed to get Moonlight 
installed, let’s move on to how we can use it. 

>STEP-04 

Setting up Moonlight 

First of all, you will need to get the IP address of your 
Windows PC on the network. Go to the Command 
Prompt (in Accessories) on the PC and enter: 
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WALKTHROUGH 


RICHARD SMEDLEY 


Having often found words better than 
pointing at things, Richard stuck with the 
command Line when all around had fled. 

twitter.com/RichardSmedLey 


You can test on the Pi if SSH is 
running, and start the service from the 
command line -- as you can any service 
(look in /etc/initd/ and /etc/init/ if 
you’re curious about other services) 

The Raspbian install image shares its 
keys with everyone else who has a 
copy. Generate your own, and personal 
keys for the user account, for secure 
remote access 


COMMAND LINE PI PART 7: 

REMOTE PI 


'Vou’M 

Heed 

> Raspbian 
raspberrypi.org/ 
downloads/ 

- though most of 
the tutorial series 
will work with the 
command Line 
running the Linux 
default Bash shell 
on any GNU/ 
Linux PC. 


r 


INTERRUPTED 

SERVICE 

While you can 
restart most 
services with 
sudo service 
ssh restart, 
replacing 
restart with 
reload will allow 
configuration 
changes to be 
registered with 
Less disruption 
- important for 
some projects. 


Richard Smedley presents your cut-out-and-keep guide to using the 
command line on the Raspberry Pi. In part 7, he covers accessing the Pi 
from remote PCs and devices, with Secure Shell 


O t’s great that the Raspberry Pi is so portable, 
but sometimes you may want to use it 
without taking it with you. Here, the Pi’s 
default operating system is a real strength, as Unix- 
like OSs have been used this way for over 40 years. 

Over the decades, as the internet has given the 
opportunity for malicious users to connect to your 
computers, old standards like telnet and rlogin have 
been replaced by Secure Shell (SSH), based on public- 
key cryptography. The good news is that once set up, 
secure connections are just as easy, and are open to 
scripted, automatic connection for your projects. 

With Raspbian, the SSH server is enabled by 
default. If not, run sudo raspi-config, then enable 
SSH (found in the advanced settings). Check the IP 
address assigned to the Pi with if config (hnet addr’ 
for the etho interface). Now you can try connecting 
from another computer on your network. 

Connecting with SSH 

From a Mac or GNU/Linux computer, just use ssh 
from a terminal to connect to your Pi. Assuming a 
default setup, and ifconfig revealing an IP address 
of 192.168.0.2, connect with: 

ssh pi@192.168.0.2 


...and enter your password when asked. From a 
Windows PC, youTl need to install an SSH client: we 
recommend Putty (bit.ly/idTlXSg), which also works 
with scp, telnet, and rlogin, and can connect to a serial 
port. Android users can try the ConnectBot client. 

You should now be at the command-line interface 
of your Pi. If you got any sort of error, check from the 
Pi that SSH is really up and running by entering 
ssh@localhost on the Pi itself - if that works, SSH 
is up and running on the Pi, so take a closer look at 
network settings at both ends. 

Hello, World 

Now we can access the Pi on the local network, it’s time 
to share with the world. Step one, before even thinking 
about going further, change the PermitRootLogin yes 
entry in /etc/ssh/sshd_config to read: 
PermitRootLogin no 

...using sudo nano. After making any changes to 
the SSH server’s configuration, you must restart the 
service for them to take effect, or at least reload the 
configuration file: 
sudo service ssh reload 
Note there’s also a file in /etc/ssh/ called ssh_config, 
which is for the SSH client; the d in sshd_config is short 


48 


September 2015 


raspberrypi.org/magpi 



Tutorial 


COMMAND LINE 


for ^daemon\ the Unix term for a service which runs 
constantly in the background. 

Other useful changes include port 22 to any unlikely 
number - but check it works afterwards. Youhl need 
to begin ssh -p 12123 or whatever to tell your client 
youhe not using the default port 22. 

To reach your Pi from anywhere on the internet, you 
need an IP address, which will connect you to your board 
even though it’s behind an ADSL router (of course, if 
your Pi is in a data centre, with its own public IP address, 
you don’t need any workaround). 

There are numerous services such as DuckDNS.org 
providing free-of-charge dynamic DNS (DDNS), to point 
a constant IP address to the changing one allocated to 
you by your ISP - but since the largest of them, DynDNS, 
ended its free service, that does provide a reminder that 
you cannot expect a free service to be around for ever. 

There are several steps to configuring a DDNS setup, 
no matter which service and software client you choose. 
Some are detailed in the RaspberryPi.org forums, and 
there’s a good guide to ddclient at samhobbs.co.uk. 

Otherwise, if your broadband router can handle both 
port forwarding and dynamic DNS, you can set it up to 
point to port 22 (or a chosen alternate port) on the Pi. 
You may even find your ISP offers static IP addresses. 

Bye bye FTP 

FTP, dating back to 1971, was not designed for 
security - data, and even passwords, are transmitted 
unencrypted, scp, the Secure Copy Program, which runs 
over SSH, is included in the Pi’s SSH packages. The 
syntax of the command is fairly familiar, as it mimics 
the command-line cp program, adding in the path for 
the remote side of the transaction’s network address, 
scp pi@192.168.0.2:/home/pi/bin/lein . 

Here we’re transferring a file from the Pi, across a local 
network, to the current location (the dot shortcut). Note 
that you can use wildcards for groups of similarly named 
files, and can recursively copy directories and their 
contents with the -r switch after scp. 



key with: name, email, or machine and project, 
for example. If you press ENTER at the passphrase 
step, you’ll get a key with no passphrase, which 
makes life easier when making scripted (automated) 
connections, but removes an extra layer of security. 
You can create keys from any computer with the SSH 
package, and move the public key to the Pi - but we’ll 
work on the assumption that the Pi is the only handy 
*nix computer, generating the keys there. 

If you accepted the defaults, your personal keys 
will now be in ~/.ssh with the correct permissions. 

By default, sshd looks in ~/.ssh/authorized_keys 
for public keys, so copy the contents of id_rsa.pub 
to there - the following will work even if you already 
have an authorized_keys with contents (make sure 
you use both >> symbols with no gap between them): 
cd '-/.ssh && cat id_rsa.pub 
>> authorized_keys 
Copy the private key to ~/.ssh on your laptop, 
or wherever you will access the Pi from, using scp, 
removing it from the Pi if it’s to act as the server. 

Once you confirm SSH works without passwords, 
you can edit /etc/ssh/sshd_config to include 
PasswordAuthentication no - or if sticking with 
passwords, replace raspberry with something stronger. 


LOST KEYS? 

The private key 
half of your key 
pair should be 
kept secure - but 
safe, too. Keep 
a backup of the 
private key on a 
memory card in 
a safe place. 


Left There’s a lot 
of configuration 
in Samba, but 
simply adding 
your WORKGROUP 
name to the 
default settings 
should get you 
up and running 


A secure key 

If you’re trying this on something other than 
Raspbian, you may not have the SSH server installed. 
It’s often found in a package called openssb-server. 
With Raspbian, you have a pair of keys (public and 
private) in /etc/ssb/ - unfortunately, they’ll be the 
same as those held by everyone else with a copy of the 
Raspbian image that you downloaded. Follow these 
steps to create new keys. 

First, remove the existing keys: 
sudo rm /etc/ssh/ssh_host_* 

. . .or move them somewhere out of the way. 
Regenerate the system-wide keys with: 
sudo dpkg-reconfigure openssh-server 
But for keys personal to you as a user, type 
ssh-keygen -t rsa -C "comment" - where 
^^comment” is anything you want to identify the 


Shared drive 

You may be using a service like Dropbox to share 
files between machines - no need to do this on a 
local network, as putting Samba on the Pi lets even 
Windows PCs see it in Network Neighbourhood, 
and access it as a shared drive: 
sudo apt-get install samba samba -common -bin 
Now edit /etc/samba/smb.conf with a WORKGROUP 
value (for Windows XP and earlier - try workgroup 
= WORKGROUP) and/or HOME (For Windows 7 and 
above). Ensure Samba knows pi is a network user: 
sudo smbpasswd -a pi 
Then restart with: 
sudo service samba restart 
The Pi should now show up in Windows Explorer 
under Network. You can fine-tune smb.conf for 
what’s shared (including printers), and permissions. 


SAMBA 

STEPS 

Samba is 
extremely weU. 
documented, 
with separate 
man pages for 
everything from 
smb.conf to 
smbpasswd, 
and excellent 
online books 
at samba.org - 
look for smb.conf 
examples. 
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SEAN MCMANUS 

Sean McManus is a Code Club 
volunteer and wrote the book Scratch 
Programming in Easy Steps. He co-wrote 
Raspberry Pi For Dummies. 

sean.co.uk 

twitter.com/musicandwords 


ADDA 

HIGH SCORE 
TABLE TO YOUR 
SCRATCH GAME 


^ouU 

Heed 



Tick the box 
in the Blocks 
Palette to see 
the List and edit 
its values. No 
cheating, now! 


The sprite checks 
the player’s score 
and tells them 
how they did 


Keep players coming back for more by keeping a record of the best scores, 
and telling them how they measure up 


O his project features scripts that enable you to 
create a high score table, and then add new 
scores to it if they’re high enough. There isn’t 
an easy way to display and hide a list from within 
your program, so the scripts also tell players how they 
ranked and what the next highest score is, so they 
know how close they came to beating it. This code will 
work with most simple games, but you might need 
to make some changes if your game invites players 
to play again, or has scripts that continue when the 
game has ended. 



>STEP-01 

Make your gome 

You’ll need a game to add this script to - either one 
of your own, or one that you’ve programmed from 
a book or magazine. Try playing the game a few 
times to work out the likely scores. Some games 
award a few points, some hundreds, and some 
thousands. The starting numbers in your high score 
table should present a challenge to players, but not 
be completely unachievable. Take care with your 
own games: if you’ve spent days playing them in 
development, they’ll be much easier for you than 
anyone else. 

>STEP-02 

Add your high score sprite 

The scripts for the high score can all go on the 
same sprite. This sprite will tell players if they got 
a high score. It could be the main character of your 
game, the sprite used on the title screen (see The 
MagPi #36), or it could be a new sprite. We’ve added 
the sprite royalperson for our high score table. 
You’ll find it in the 'people' folder, even though 
it looks like a dog. It’ll be in the way during the 
game, so add Listing 1 to hide it when the green 
flag is clicked. 
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HIGH SCORE TABLE IN SCRATCH 


LISTING 1 



when 1 rfKeivf* hfgh 

delate §MW% of high soore$ 

^ high score loop to m 
repeal 

iri$<rt Nigh iicor« loop at 
change high scoro loop by 


LISTING 3 





I This code will work with most simple games, 
but you might need to make some changes 
if your game invites players to play again 


If 


>STEP-03 

Set up your list 

Your high score table will be stored in a list. Click 
the Variables button above the Blocks Palette, click 
the button to make a list and call it ^high scoresk In 
the Blocks Palette, you can click the tickbox beside 
the list name to show or hide the list on the Stage. 
This is a handy way to view the whole list, and you 
can edit the values in it by clicking them and typing 
on them. The list gets in the way of your game, so 
we recommend unticking the box. 

>STEP-04 

SGt your starting scores 

You can type some starting scores into the list on 
the Stage, but it’s better to use a script to generate 
your high scores. Listing 2 does this. It runs if it 
receives the broadcast reset high scores, but you 
can also click the script once to reset your scores. 

To change the lowest score, change the value in 
the set high score loop block. To change how 
much scores go up by, edit the value in the change 
high score loop block. Note: the pointed Operator 
blocks are shown as rounded in our code because of 
limitations in the Scratchblocks software we use for 
laying out code for the magazine. 


>STEP-05 

Add your high score code 

Listing 3 checks the score and adds it to the high score 
table in the correct position if high enough. It also tells 
the player how well they did. Add it to your high score 
sprite. Take care with building the script that goes in 
the hole of the repeat until block. YouTl need to drag 
in blocks in a similar order to this: or, >, item 1 of 
high scores, high score loop, =, high score loop 
When the next highest score is announced, add blocks 
in the order: say Hello ! for 2 secs, join hello 
world, item 1 of high scores, -, high score loop. 

>STEP-05 

Patch it in to your gome 

To finish, connect your high score script to your game. 

If the game doesn’t already use the variable score, click 
on Variables and make that variable for all sprites. You 
want the high score script to run when your game ends, 
so you need to add some code at that point in your game. 
Add a block to set score to your game’s score variable if 
you’re not already using the variable score in the game. 
Finally, add a block to broadcast check high scores. To 
keep your high scores, simply save your game. When you 
save a Scratch program, the list values, including your 
high score table in this case, are saved too. 
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MIKE'S PI BAKERY 



MIKE COOK 

Veteran magazine author from the old 
days and writer of the Body Build series. 
Co-author of Raspberry Pi for Dummies, 
Raspberry Pi Projects, and Raspberry Pi 
Projects for Dummies. 
bit.Ly/iaQqui5 
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ticcd 

> Webcam 

> Raspberry Pi 2 
Model B 

> Multiple colours 
of acrylic paint 
and primer 

> Adjustable 
neutral density 
filter (optional) 

> 20mm Ms 
threaded spacer 

> 20 X 20mm 
pine strip 

> 17 X 6mm 
pine strip 

> 6mm MDF 

> 6mm plywood 

> 6mm dowel 

> 4x miniature 
hinges 

> imm foam strip 

> Assorted nuts 
and bolts 
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COMPUTER VISION 

SEQUENCER 

Build up a musical piece by putting coloured pegs into holes 
with this exciting computer vision project... 



Gratuitous car from 
the Safari Park project 


= Peg board for physical sequencer 


O ne of the new territories the Raspberry Pi 

opens up for exploration is video processing/ 
computer vision, and we have a number of 
ideas for projects we can do using these techniques. 
This month we want to see how to get a basic setup 
going and make a seemingly simple project with 
it. However, as you will learn, nothing is quite as 
easy as it seems when it comes to computer vision. 


The basics 

We will be using the OpenCV computer vision library 
for these projects. If you donh already have it 
installed on your Raspberry Pi, then we would advise 
you to look up TheMagPi #32, where Willem Koopman 
wrote an excellent article (page 48) on how to install 
it and do a bit of facial recognition. It can take a 
few hours to install, depending on your internet 
connection speed and what Pi model you have. 

We would recommend using a Pi 2 for all computer 
vision work, as you need all the processing speed 
you can get. 

Next, you need to get hold of a compatible 
webcam. You could use the Raspberry Pi’s own 
Camera Module, but this is not recommended 
because of its high resolution. A high resolution 
means lots of pixels, which means lots of 
pixels to process, and that takes time. 

It is normal to work on images as small 
as possible with computer vision work, 
to minimise the amount of processing 
you have to do. Many webcams have a 
curved clip arrangement for hooking on top 
of your monitor; while this looks unpromising 
from an adaptation point of view, it in fact 
proves to be very easy to mount on a piece of your 
own hardware. Simply unscrew the joint, remove 
the bottom part of the clip, and mount the camera 
on a single pillar or spacer. 
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The webcam stand 

One thing that takes a lot of processing time is 
the location of objects. You can circumvent this by 
making a stand and tray for the webcam. We made 
a bipod - that is, a tripod but with only two legs. 
Normally this would not be stable, but by bracing 
it in slots either side of the frame and having a base 
board fill the frame, something robust enough for our 
experiments could be made. We made the webcam 
stand from a combination of strip pine, plywood, 
and MDF. The construction is in two parts: a stand 
and an A4-size base. We made the stand capable of 
being adjusted to two heights. The tallest height was 
designed so that the whole of the base could be seen 
by the camera, and the lowest so the camera field 
could be concentrated on a small area of the base. 

This added a bit of complication to the design, but 
was well worth it. For this project, we used the stand 
at its lower position. The legs are held in position by 
Mb bolts; no nuts were needed (see the step-by-step 
guide on page 55 for full details of construction). 

While the webcam we got worked fine using other 
software, when it came to using it with OpenCV 
the images were very much overexposed and it was 
way too sensitive to light, resulting in the colours 
being all washed out. Despite trying many software 
remedies to control the exposure, our webcam 
stubbornly refused to succumb to any type of 
meaningful control. In the end, we reverted to buying 
an adjustable neutral density filter (from eBay at 
just under £7) to control the exposure of the image. 
You might be luckier with your camera. 

The software - principal 

There are a great many tutorials online detailing 
how to use OpenCV with Python, and some of them 
actually work! The majority, however, do not; this 
is due to changes in the way commands work and 
the way they are specified in the latest version of 
the library. All the tutorials seem to be one or two 
software revisions behind the current one. This can 
lead to a bit of frustration from a beginner’s point 
of view and make it difficult to learn the language. 
The other frustration is that the window OpenCV 
generates to show the image does not behave like 
normal windows; the close X box will not shut it 
down. It will appear to close, but then it will open 
up another window in a random place on the desktop. 
It seems there is no simple solution to this; there 
might be a complex, labyrinthine Linux solution, 
but this distracts from the job in hand. 

One way to think of a webcam is that it is a vast 
array of colour sensors; if you know where to look, 
you can easily pick out a colour. That was the 
thinking behind making a physical sequencer: simply 
have a handful of coloured pegs and stick them into 
holes in a board. Then use the pegs to generate a 
sound sequence, with the colour determining the 


sound and the position determining when that 
sound is played. That sounds so simple, but to get a 
computer to do it is not so easy. The first problem is 
where to look; you might think this is simply evenly 
spaced across the area of the board, but that is not 
taking perspective into account. A peg only looks 
like it is a round shape on a grid when the camera 
is directly above it. If the camera is off to one side, 
then it will look decidedly off the grid. The solution 
is to have a record of where every point you want to 
sample actually is in the image, then your program 
knows what pixels to look at. Gathering these 
points is a tedious and repetitive operation, which is 
fortunately just what a computer is good at. So the 
first program we have is one to gather all the sample 
points and put them into a file. Then the sequencer 
software proper can simply read this file and use 
it to control the notes and the timing. 

Handling calaurs 

The next problem is identifying the colour of a 
pixel. Sure, you can just read the red, green, and 
blue components of any pixel on the screen, but it 
is not as simple as that. This is because the same 
object can return different RGB values depending on 
the lighting, the angle between the object and the 
camera, and even where in the camera’s field of view 
it is. Also, different shades of a colour produce vastly 
different numbers. Therefore, we need a more robust 
way of defining a colour than just three values. What 
we need is that each colour is defined not by a specific 
number but by a range of values. It is a bit complex 
defining a range over three values, so it would be 
simpler if the three colour values were distilled down 
into a single value representing the colour. This is 
what is done with the HSV colour space model, which 
defines a colour as three parameters: H (hue), S 
(saturation), and V (value or brightness). 

The H value is just what we want to categorise the 
pegs, but what if there is no peg? This is where the 
^chroma’ parameter comes in. This is the deviation 
a colour has from the grey line - a line in colour 
space which joins black to white. Colour space 
simply means expressing the parameters of a colour 
as if it were a geometrical space, hence the RGB 
representation of a colour is often known as a colour 
cube, and any colour can be thought of as a point in 
that cube. So we only need to consider categorising 
the colour of a pixel once it is known to be coloured 
and not grey. The H values can be simply divided up 
into bins and any unknown colour assigned a colour 
number, depending on what bin it falls into. Note 
that these bins are not evenly spaced, as there are 
a large number of H values that the eye sees as blue 
compared to the small number it sees as red; this 
applies to the other colours as well. 

So now we have the theory, we can start to look 
at how this can be put into practice. 
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The calibration code 

First, look at the calSetter.py code (page 56). This 
gathers sample points in the video frame and puts 
them into a file. As set up, it gathers eight rows of 
eight equally spaced points by simply clicking on the 
start and end points. This allows you to compensate 
for the perspective distortion over the whole peg 
board by selecting the far left side followed by the 
left centre peg, then the right centre peg followed by 
the far right peg. This is repeated for each of the four 
rows and then you have the opportunity of writing 
the resulting points out to a file. The configuration 
for this is set up using the ppr and nor variables. 

The main function prints out some instructions 
and then enters a while loop, which displays the 
current frame from the webcam and overlays circles 
at the points already defined by calling the overlay 
function. The current mouse pointer is used to also 
draw a circle; this is tracked by the mouse callback 
function track_mouse. When a mouse click happens. 


pi 


The program runs under 
the Pygame system to 
handle the sounds 


the location of that click is stored and, on every other 
click, points are defined between the last two clicks 
with the calculatePoints function. When all the 
points have been defined, you can press the S key to 
save them and type in the file name you want to use 
to the Python console. This will then close down the 
program, as will pressing the ESC key at any time. 
Note that you can use this program to define any set 
of points over the video field; use your imagination. 
Donh expect a rapid response from the mouse, since 
there is a lot going on here; just move slowly and the 
circle will follow eventually. 

The sequencer cade 

The pickle package is used to format the data so 
that it can be read in directly by another program 
and simply restore the points tuple list. This is 
picked up by the videoSequencer.py program (page 
56), which is the physical sequencer proper. The 
program runs under the Pygame system to handle 
the sounds, which are stored in a sounds directory at 
the same level as the program. There are six different 
colours recognised, each one triggering a different 
sound. At each of the 16 steps, up to four different 
sounds can be produced; this is known as four-note 
polyphony. The program has two sliders attached 
to the window: one to switch the sequencer on and 
off, and the other to set the speed in BPM (beats 
per minute). These sliders are not as responsive 
as you might hope, so give it a second or so when 


moving them. An image is taken then analysed for 
the colours, and then the sounds are outputted in 
turn until the end of the 16-step sequence. Due to 
the time it takes to output the sounds, the OpenCV 
video buffer has filled up with four frames, so these 
are read off quickly so that the last image frame you 
read is the latest frame. This means you have the 
whole sequence time to change any pegs for the next 
run-through. The program can be quit in two ways: 
pressing the ESC key quits the program, whereas 
pressing the D key saves a CVS (comma-separated 
value) file, containing the colour value for each 
position, before quitting the program. This file can 
be opened with any text editor or by a spreadsheet 
program; it will allow you to fine-tune either the 
picture or the bins that define the colours in the 
getColour function. You can move the boundaries 
around or even add more colours if you like. The 
colours are taken from the average of a 3x3 pixel 
square centred around the target pixel, to minimise 
single pixel errors. The chroma threshold - that is, 
the point where a pixel value is considered to be a 
valid colour and not grey - is set by the cromaThresh 
variable. While playing the sequence, the four 
positions defining the sound are joined together 
with a thick green line. This gives a visual indication 
of where in the sequence you are and how close to 
the end it is, so you can avoid getting your hand in 
the next frame. However, you might want to do that 
intentionally, as it seems to result in a small solo 
that relieves the repetition. Unfortunately, mouse 
movement makes the operating system steal some 
time from the program, so the green sample lines 
might stop being updated if you waggle the mouse 
around. When the sequencer is turned off by the 
slider, the video is updated as fast as possible; this 
allows you to adjust the peg board’s position to 
match up with the sample points that are shown 
outlined by a dotted square. 

Custamisation 

Like all Bakery products, it’s now ready to spread 
your own jam across it. You can change the sound 
samples or the sequence length/polyphony. We used 
colour swatches from the DIY store to add variety 
to the last row, by slipping it over the peg board for 
the next sequence. You can replace the peg board 
with a coloured drawing or photo from a magazine 
and see what that sounds like. You can experiment 
with different sample points for a picture and change 
the code so you can type in what sample file you 
want to use. You can include many sample point 
files and switch between them at the end of each 
sweep through the sequence. How about changing 
the sound samples to notes from an instrument, 
extending the number of rows, and making a virtual 
music box? We’re sure you can think of many ways 
to take this project further. Have fun! 
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BUILDING A CAMERA STAND AND PEG BOARD 


>STEP-01 

The inner slider legs 



>STEP-02 

The outer support 


>STEP-03 

The camera plate 


>STEP-04 

The base 


>STEP-05 

The peg board 


Make the inner slider legs - you need two of 
these. At first we used white woodworking 
PVA, but in the end this proved not to be strong 
enough, and it also took 24 hours to set A much 
betterjoint was obtained by using ‘Gorilla Glue’ 
(a foaming adhesive), with both sides of the 
joint being slightly moistened before applying 
a thin layer of glue and clamping them together. 
The glue will foam out of the edges and can be 
removed with a sharp knife or sandpaper after it 
has set which should only take about two hours. 



Make the outer support - again, you need two 
of these. Cut the two 238mm strips of 17mm 
wide by 6mm thick stripboard, and also the 
single 54mm piece. Clamp and glue the edges 
together to make a long U shape. Use the 
inner slide wrapped in a piece of cling film as 
a spacer on the open end to make sure it is 
all square. Again, clamp to squeeze the Joints 
together as well as clamping along the top. 
When the glue has set, remove the clamps 
and handle carefully so that you don’t crack 
the Joints. Next, clamp and glue the three 



Make the camera plate. Ours was made from 
a piece of loomm by 89mm plywood, mainly 
because we had a piece already, but there is 
no reason why you can’t make it from MDF. A 
40mm diameter hole was cut in the middle 
using a saw drill. A 3mm hole was placed in 
the point in the diagram to allow the camera 
mounting pillar to be attached. The camera 
plate is attached to each of the sliding legs by 
two small hinges and M2.5 nuts and bolts. Two 
blocks were cut and glued onto the underside 
of the camera plate to act as stops for the legs. 



Once the stand has been made, it’s time to 
construct the base. This is designed to be an 
A4 tray that you can mount the webcam over. 
The base is made from four pieces of 21mm 
square strip pine - two at 340mm and two at 
253mm. The ends of each piece were cut ofF at 
45 degrees. A recess was cut in the middle of 
the two shorter sides, to allow the legs of the 
stand to sit flush with the frame. The frame was 
glued on the diagonal corners and was held 
together with a ‘square clamp’ until the glue set. 



You can use the tray to make the peg board, 
or you can copy us and make the board from 
a 170mm by 85mm piece of MDF. Drill the 
holes in the peg board at 6.5mm diameter and 
paint it grey. We made a bit of grey paint by 
adding a touch of black paint to some white 
paint, but don’t mix too much. Remember, 
the MDF will need a coat of MDF primer first, 
and don’t forget to paint inside the holes. 


Cut and arrange the four strips of 17mm wide 
by 6mm thick stripboard and glue and clamp 
each edge. We used clamps to squeeze them 
together, as well as a clamp over the top to make 
sure this produced a flat and not warped small 
rectangle. To stop the work sticking to the bench, 
we used a sheet of cling film from the kitchen 
to stop the glue sticking in the wrong place. The 
clamping is important: the instructions on the 
glue say that the Joint’s strength depends on 
the tightness of the clamping. 

89mm strips to the top of this U shape; this 
time, only downward pressure clamps should 
be necessary. Finally, when this is set, flip it 
over and glue the other three 89mm strips to 
form the outer frame. You can insert a small 
square of spacer material under these strips 
to give a little play, to allow the inner slider 
to move freely but not sloppily. We didn’t do 
this on the prototype - instead we sanded the 
inner slider to reduce its thickness slightly - but 
next time we will use a piece of 0.5mm styrene 
sheet to make life easier. 

A small piece of black foam was added to the 
end of the block to give a bit of springiness to 
the legs. If you are fitting a neutral density filter, 
then you might have to file a slight curve in the 
blocks to make room to fit the filter. The filter 
should be attached to the camera plate with a 
very small amount of hot-melt glue. If you do 
use a filter, you need to get a small piece of 
cardboard with a 10mm hole to fit on the top of 
the mount between the camera and the board, 
to suppress reflections from the top of the filter 
into the lens. 

Then a 340mm by 253mm piece of 6mm MDF 
was cut to make the bottom. It was drilled and 
countersunk so that eight screws could screw 
it into the frame - we used two screws for each 
side of the frame. When the frame was screwed 
to the base, the corners were rounded ofF using 
a disc Sander. Screwing the base to the frame 
in this way allows you to remove the base to 
make fine adjustments to the recesses. Finally, 
a 296mm by 210mm piece of 6mm MDF was cut 
to make a tray that held the legs apart. 

Cut the pegs from 6mm dowel at a length 
of 20mm; this is a good compromise length 
between handleability and not producing much 
distortion on the camera. Paint the pegs with 
acrylic paint - a good source of low-cost paints 
can be found in the multi-tube artist sets of 
paints available from many retailers. Again, 
we found that adding a primer to the pegs first 
meant the colours were bright and uniform. 
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caiSetter^y 

# calSetter - defines a grid of sample points 
import cv2 

import oSj pickle 

ppr = 8 # points per row 
nor = 8 # number of rows 
maxclick = nor * 2 
ix,iy = -1,-1 

target = [(-10, -10), (-10, -10)] 
pointer = 0 
showRow = False 

points = [ (-10,-10) for p in range (0,ppr*nor) ] 

# mouse callback function 

def track_mouse(event, x,y, flags, param) : 
global ix,iy, pointer, showRow 
if event == cv2. EVENT_LBUTTONDOWN: 

# save mouse position 
if pointer == maxclick : 
pointer = 0 
showRow = False 
target [pointer & 1] = (x,y) 
if (pointer & 1) == 1: 

calculatePoints(pointer / 2) 
showRow = True 
pointer +=1 

if pointer == maxclick: 

prinf'locate start point on row 0 again or 's' to 
save points" 
else : 

if (pointer & 1)== 0: 

print "locate start point on row", pointer/2 
else : 

print "locate end point on row", pointer/2 
elif event == cv2. EVENT_mUSEmVE : 
ix,iy = x,y 

cv2. namedWindow( "Sample point define", cv2.CV_WIND0W_AUT0SIZE) 
camera_index = 0 

capture = cv2.VideoCapture(camera_index) 
if not capture. isOpenedO : 
capature.openO 

cv2. setMouseCallback( "Sample point define", track_mouse) 

def main() : 
global frame 

prinf'Define", nor, "rows of ", ppr, "points per row" 
prinf'press Esc to quit" 
print "locate start point on row 0" 
while(True) : 

ret, frame = capture. read() 

cv2. circle (frame, (ix,iy),10, (0,0,255),1) 

cv2 . line(f rame, (0, 240) , (640, 240) , (0, 0, 225) , 1) 

cv2 . line(f rame, (320, 0) , ( 320,480) , (0, 0, 225) , 1) 

overlay 0 

cv2. imshow( "Sample point define", frame) 
k = cv2.waitKey(l) & 0xFF 
if k == 27: 
finishO 

if (k == ord('s')) & (pointer == maxclick) : 
print "save points - click on Python console" 
fName = raw_input("type file name ") 
prinf'saving points to file", fName 
f = open(fName+' .txt ' , 'w' ) 
pickle. dump ( point s,f) 
f .closeO 
finishO 


def finishO : 

prinf'all done" 

capture. releaseO 

cv2 . destroyAllWindows ( ) 

cv2.waitKey(l) 

os._exit(l) 

def calculatePoints(row) : 
global points 
startx = target[0][0] 
starty = target[0][l] 
endx = target[l][0] 
endy = target[l][l] 

xinc = float((endx - startx)/ (float(ppr) - 1.0) ) 
yinc = float((endy - starty)/ (float(ppr) - 1.0) ) 
for point in range(0, ppr) : 

points[point +(ppr*row)] = (startx + int(xinc * point), starty + 
int(yinc * point) ) 

def overlay (): 
global pointer 
if pointer & 1 == 1 : 

cv2. circle (frame, target [0], 10, (0,255,0),!) 
if showRow : 

# draw the sample row positions defined so far 

for i in range (0, (pointer/2)*ppr) : 

cv2 . circle (frame, points [i] , 10, (0, 255,255),!) 

if name == ' main ' : 

main() 

videoSequencer^ 

#! /usr/bin/env python 

# Video sequencer with track bars 

# and multi-pixel sampling 
import time, pygame, pickle 
import os, sys, math, copy 
import cv2 

pygame. init() # initialise Pygame 
pygame . mixer . quit ( ) 

pygame. mixer. init(frequency=22050, size=-16, channels=4, buffer=512) 
pygame . event . set_allowed (None) 

samples =["clap", "closedhat", "cowbell", "crash", "hitom", "lotom"] 
colours = ["Red", "Orange", "Yellow", "Green", "Blue", "Magenta"] 
maxCol = 6 

seqSound = [ pygame.mixer .Sound("sounds/"+samples[sound]+" .wav") 
for sound in range(0,maxCol) ] 

cv2.namedWindow( "Video Sequencer", cv2.CV_WIND0W_AUT0SIZE) 
camera_index = 0 

capture = cv2.VideoCapture(camera_index) 
if not capture. isOpened( ) : 

capture.open(camera_index) 
hList = [ 0.0 for h in range (0,64)] 
cList = [ 0.0 for c in range (0,64)] 
nextNote = time.time() 

cromaThresh = 0.23 # threshold for a colour 
def track_mouse(event,x,y, flags, param) : 
pass 

cv2.setMouseCallback( "Video Sequencer ",track_mouse) 
def main() : 

global capture, samplePoint 

f = open ( 'gridl6x4.txt', 'r' ) # change to use another points file 
samplePoint = pickle. load(f) 
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f .closeO 

prinftype Esc to quit - d to save colours to a CSV file and quit" 
for c in range(0jmaxCol) : 

print colours[c]/'for"jSamples[c] 
cv2.createTrackbar( 'BPM' ^ "Video Sequencer"jl20j200jnothing) 
switch = '0 : Stop \nl : Run' 

cv2.createTrackbar(switchj "Video Sequencer" j 0^1 ^ nothing) 
startTime = time.time() + 3 

while StartTime > time.time(): # let web cam's AGC settle 
retj frame = capture. read() 
cv2.imshow( "Video Sequencer" ^ frame) 
c = cv2.waitKey(l) 

while True: 
ret = True 

for i in range (0,5) : # read off 5 frames 
ret, frame = capture. read() 
points(frame) 

cv2.imshow( "Video Sequencer", frame) 
getKeyO 

if cv2.getTrackbarPos(switch, "Video Sequencer") == 1 : 
soundOut(frame) 

def getKeyO : 

k = cv2.waitKey(l)& 0xFF 
if k == 27: 

terminate(False) 
if k == ord( ' d ' ) : 
terminate(True) 

def soundOut (frame) : 
global nextNote 

bpm = 60.0 / float(cv2.getTrackbarPos( ' BPM' , "Video Sequencer")) 
if bpm > 2.0: 
bpm = 2.0 

for i in range(0,16): 

temp = cv2.copyMakeBorder (frame, 0,0, 0,0,1) 
cv2. line (temp, samplePoint [i] , samplePoint [i+16] , (0, 255,0) ,3) 
cv2. line (temp, samplePoint [i+16] , samplePoint [i+32] , (0, 255,0) ,3) 
cv2. line (temp, samplePoint [i+32] , samplePoint [i+48] , (0, 255,0) ,3) 
while nextNote > time.time() : 
pass 

nextNote = time.time() + bpm 
cv2.imshow( "Video Sequencer", temp) 
getKeyO 

for j in range(0,4): 
index = i + (j*16) 
if cList[index] > cromaThresh : 

seqSound[getColour(hList[ index] ) ] .play() 

def nothing(x): # dummy callback function for track bars 
pass 

def output(): # CSV format 

prinf'Saving colours to file - colours. csv" 
with open( ' colours. CSV' , 'w' ) as f: 

f .write("Hole, Hue, Chroma, Colour \n") 
for c in range(0,16): 
f .write("\n") 
for r in range(0,4): 
i=(r*16) + c 

entry = str(i)+ ", "+"%.2f" % hList[i] 
f .write(entry+", ") 
entry = "%.2f" % cList[i] 
f .write(entry+", ") 
if cList[i] > cromaThresh : 

f .write(describeColour(hList[i] )+"\n") 
else : 

f .write("neutral \n") 

f .closeO 


def getColour(h) : 



colour = -1 



if h < 1 or h > 340: 

colour = 0 

>PYTHON 




if h>l and h< 30: 

DOWNLOAD: 


colour = 1 

Github.com/ 


elif h>30 and h< 90 : 

Grumpy-Mike/ 


colour = 2 

Mikes-Pi-Bakery/ 


elif h > 90 and h < 190 : 

tree/master 


colour = 3 



elif h> 190 and h< 300 : 

PROJECT 


colour = 4 


elif h> 300 and h < 340 : 

VIDEOS 


colour = 5 



return colour 

Check out Mike's 
Bakery videos at: 

vimeo.com/ 


def describeColour(h) : 

channels/ 


colourNumber = getColour(h) 

mikespibakery . 


if colourNumber == -1: 

^ 



colour = str(h)+" is unknown" 
else: 


colour = colours[colourNumber] 
return colour 


def points(frame) : # outline sample area and get the colours 
for point in range(0,64): 

surround (samplePoint [point] [0] , samplePoint [point] [1], 

(0,0,0), frame, point) 

def surround(x, y, col, frame, place): 
getCol(x,y, frame, place) 
frame[y, x-2] = col 
frame[y+2,x-2] = col 
frame[y-2,x-2] = col 
frame[y+2,x, ] = col 
frame[y-2,x] = col 
frame[y,x+2] = col 
frame[y+2,x+2] = col 
frame[y-2,x+2] = col 

def getCol(x,y, frame, place) : 
global hList,cList 
bt = rt = gt = 0 
m = 255.0 * 9.0 
for ox in range(-l,2): 
for oy in range(-l,2): 

blue, green, red = frame [y+oy,x+ox] 
bt += blue 
gt += green 
rt += red 

r = float(rt) / m # normalise colours 

g = float(gt) / m 

b = float(bt) / m 

alp = 0.5*(2*r - g - b) 

bet = 0.866*(g - b) 

hList[place] = math. degrees(math.atan2(bet, alp)) 
if hList[place] <0 : 

hList[place] = 360 + hList[place] 
cList[place] = math.sqrt(alp * alp + bet * bet) 

def terminate(debug) : # close down the program 
if debug : 

output 0 # colours to a csv file 
print ("Closing down please wait") 
pygame.quitO # close Pygame 
capture. releaseO 
cv2 . destroyAllWindows ( ) 
cv2.waitKey(l) 
os._exit(l) 


if name_ 

main() 


raspberrypi.org/magpi 


September 2015 Ma^i 


57 


Tutorial 


WALKTHROUGH 



PART? 


MAKE GAMES WITH PYTHON 



SEAN M TRACEY 

Sean is a technologist Living in the South 
West of England. He spends most of his 
time making silly things with technology. 

sean.mtracey.org 






■X PHYSICS & 
••■COLLISIONS 

In the seventh part of this series, we create circles that 
can bounce off one another if they collide 




Below Simulate 
object collisions 


What happens when an unstoppable 
force meets on immovable object? 

In our last tutorial, we built a whole solar system! 

Well, we simulated a good chunk of it at least. Using 
vectors and a dash of maths, we created a gravitational 
attraction between objects with mass to simulate 
their movement in space. Small objects would orbit 
larger ones, large objects would move very little when 
attracted to smaller objects and vice versa, and all 
was well in the simulated world. That said, one thing 
might have seemed a little odd: when two objects 
collide in the real world, they bounce off one another 
(or implode), but in our simulation they just slipped 
by one another as if they were ghosts. That just wonh 
do! This time, weTe going to write code that lets our 
objects collide and bounce off each other. 



Sa, what are we making? 

Unlike last time, we arenh going to be using planets 
and the solar system to prettify the effect - weTe 
going to use basic circles for our program. Using 
circles makes it easier for us to use maths to calculate 
collisions, and we can change the properties of the 
circles to reflect the qualities they represent: for 
example, more mass or a bigger radius. That said, 
although we arenh using images of the solar system 
in this program, we can still think of the particles 
wehl be colliding in terms of a solar system. 

The smallest of our collidable objects will be like 
^meteors’ : they move really fast, but require less 
energy to do so. A medium-size object would behave 
much as a planet might; they move at a moderate 
speed and have more kinetic energy behind them. 

If they bump into a smaller object, they will adjust 
course, but not by much, whereas the smaller body 
will fly off! 

WeTe going to use the code from the last tutorial 
as a springboard for this one. All of our objects 
will have a mass and will attract every other object 
gravitationally using the same calculateMovement() 
method as before. 

Let’s take a quick walk through our code now. Just 
like our previous bits of code, the top of collisions. py 
(between lines 1-24) imports the modules weTl need 
for our code and declares the variables that weTl 
be using throughout the tutorial. Obviously, these 
variables are very similar to the variables we used 
for our solar system simulator, but there’s one little 
difference - instead of storing all of our planets in a 
list called celestialBodies, this time we’re storing 
all of our objects in the collidables list. 
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Lines 26-84 will also seem familiar. 
drawCollidables is the same function as our 
drawPlanetsO function, our drawCurrentBody() 

hasnh changed at all, and the same can be said for our 
calculateMovementO function which handles the 
gravity of all of our objects. Hello, old friend. 

The handleCollisionsO function on lines 
86-135 is where weTl spend our time this tutorial. 
Here, we check for colliding objects and adjust their 
trajectories accordingly. 

Lines 137-202 contain the logic for our keyboard 
and mouse interactions, as well as our main loop. 

Just as before, clicking in our window will create a new 
particle which will only affect the movement of other 
particles once the mouse has been released. If the 
mouse was moving when it was released, the particle 
will inherit the velocity of the mouse pointer. 

What do we need to know to simulate 
0 collision? 

We need to know a couple of things before we can 
simulate a collision. First, we need to know which 
two objects, if any, are colliding. Once we know 
which two objects are colliding, we need to figure out 
how fast they’re going, the angle of incidence (which 
we’ll look at in a little while), and the mass of each 
of the objects. 

So, how do we know which two objects are 
colliding? That’ s pretty simple. . . when you use 
circles. Circles are regular shapes: each point along 
the circumference is the same distance from the 
centre as every other point; this measurement from 
the edge to the centre is the radius. By measuring the 
distance between the centres of two objects, we can 
check whether or not the outline of the objects are 
intersecting (crossing into) the space of each other. 

If the distance between the centres of two circles is 
less than the radius of each circle added to the other, 
they must be colliding! Neat, huh? 

On lines 88-96, we create two for loops that let 
us work through every possible collidable object in 
our simulation. Inside these loops, we measure the 
distance between the centres of every object in our 
collidables list. We do this on line 102 with our 
distance variable, using Python’s maths module. 

If the distance between the two centres of our objects 
is more than the combined length of the radius of 
each circle, our objects are not colliding, and we then 
continue on measuring the distance to other circles. 
However, if the distance is less than the sum of the 
radii (plural for radius, in case you were wondering), 
then our objects are colliding and we can start figuring 
out what to do with them. 


Not Colliding 



Colliding 


< cNsiariDi anan 



radti > dtstanoe 

Calbdlnjj 


^WARNING! 

PYTHAGORAS THEOREM AHEAO 


The ongie of incidence 

How do we create a convincing bounce effect? 

In the past, whenever we’ve wanted to restrict or 
adjust movement, we’ve been doing so to squares 
or rectangles - shapes with flat sides. Going too 
much to the right? Okay, we’ll send it back to the 
left. Going too far down? Okay, we’ll send it back up. 
Now, we’re dealing with circles. Instead of having 
eight directions we can go in, we now have 360. If 
our circles hit each other square on (hal), then all 


Above A diagram 
of all of the 
aspects needed to 
bounce one circle 
off another 
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I Of the two objects colliding, 
the faster object will transfer 
energy into the slower object 


II 


THANKS 

A hat tip for this 
tutorial goes out 
to Steve and JefF 
Fulton. These 
guys put a huge 
amount of effort 
into dissecting 
old Flash-based 
physics code into 
its core parts and 
putting it back 
together for their 
book HTML5 
Canvas, which 
made this tutorial 



we have to do is send the circles back along the path 
they came, but these are circles with gravity; hitting 
another circle square on along the X or Y axis is not 
going to happen very often. If a collision happens a 
little to the left or right of the centre of the X or Y axis, 
we need to send our objects on two new paths, but 
how do we know which direction to send each object? 
Well, that’s what the angle of incidence is for. What 
is the angle of incidence? It’s the angle at which an 
object is travelling as it collides with another object. 

If we know the angle at which two things collide, we 
can figure out along which angle we can send them 
on their merry way - that is, the angle of reflection, 
which is the reverse of the angle of incidence. 

It’s not as complicated as it sounds. Imagine a ball 
hitting a vertical wall at an angle 45, so its vector is 
(1, 1), travelling to the right and down in equal 
measure. After the ball hits the wall, the rate at which 
the ball falls to the ground is unchanged, but the 




Above A diagram displaying angles on a circle and their 
equivalent values in radians 


direction it’s travelling is reversed along its X axis; 
our ball is still travelling at 45 degrees, but now it’s 
travelling away from the wall, at -45 degrees or with a 
vector of (-1, 1). We’ve coded this in an earlier tutorial, 
when we first started bouncing objects around a 
window (gosh, that was a while ago now!), but we 
weren’t using the terms we are here. Now we know 
why we made objects move the way we did. 

On line 107, we calculate the angle of incidence 
between the centre of the two circles colliding 
with math . atan2, which basically works out 
the hypotenuse of an imaginary right-angled 
triangle drawn using the two centre points of the 
circles. If you were to print out the value of the 
direction variable, you might expect it to read 
somewhere between 0 and 360 because an angle 
is measured in degrees, right? Nope! Instead 
you’ll get a value between 1 and 2tt (pi * 2 ): our 
angle has been measured in radians. This may 
seem counter-intuitive, but to a computer (and 
mathematicians) it makes perfect sense. If you 
want to see the degree value, you can simply do 
Yadians * (180/pi)’ , but we’re going to stick with 
radians because it keeps our code tidy. 


Bounce! 

Now we’ve got the angle of incidence, we can 
calculate which way to send our colliding objects, 
but first we need to obtain a couple of other values 
to make everything work. Next, we need to work out 
the speed at which our circles are moving. ^Hang on, 
we have vectors, why do we need a separate speed 
value?’ you ask. It’s very astute of you to realise 
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that we use vectors to affect the speed and direction 
of our objects, but that’s part of the problem: our 
vector is a measure of speed and direction. As it is, 
we can’t use the vectors to find out how many pixels 
our objects travel per frame; we need to separate the 
speed from the direction so we can perform some 
maths specific to each value. Fortunately, we can use 
maths to figure out the speed of our objects - which 
we do on lines iio-iii, one variable for each object 
in the collision - and the direction each object is 
moving in radians, on lines 114-115. 

Now we have the speed and direction of each 
circle, we can adjust them separately to create 
the bouncing effect. First, we want to reverse the 
direction that the objects are travelling in; on lines 
118-122, we create a couple of variables to calculate 
new velocities. Here we’ve recombined the speed 
and direction variables of each object to create new 
speeds for the X and Y values of our circles. When 
used together, guess what: we’ve got a new vector! 
But these ones will point our objects in the opposite 
direction of the angle of incidence - the angle of 
reflection. We’ve got the basics of our bounce. 

Motion 

Energy cannot be destroyed, only converted 
into other forms. Motion is a form of energy 
and when two objects collide, an energy transfer 
happens between them. Of the two objects colliding, 
the faster object will transfer energy into the slower 
object, speeding the slower object up and slowing 
itself down. The two objects will move off in different 
directions and at different speeds than they were 



Above Use the mouse to create a new moving object 


Before 

Impact 


Impact 


VMikj*: iS, a) < 5, Oj 




After 

Impact 



MMmm- 10.0 


O' 

Vector; (B.5, 0) 
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travelling before the collision, but the net energy 
of motion - the total amount of energy moving the 
objects - will remain exactly the same; it’s just in 
different quantities in different objects now. 

On lines 125 and 126, we take into effect the 
mass of each of the objects colliding, as well as the 
speed. The result is that bigger objects will take 
more energy to change direction than smaller ones. 
With this in place, we won’t have large objects 
being sent off at high velocities by much smaller, 
faster-moving objects - just like in the real world. 
Remember, this is all about simulating physics - if we 
wanted to accurately calculate interactions between 
multiple objects as if they existed in the real world, 
we’d need a computer much more powerful than 
our Raspberry Pi. 

Now we have the new vectors for our colliding 
objects, all we have to do is apply them to our 
objects. We’re only going to apply the X values 
we’ve calculated to each object. If we applied both 
the adjusted X and Y values to each object, they 
would bounce and follow the path they came along. 
That would be like throwing a ball and having it 
bounce straight back into your hand - it’s not 
natural! By only applying the X value to each 
of our colliding objects, we create a convincing, 
bouncing, deflecting effect, and we do that 
on lines 129 and 130. 

And that’s it. Rinse and repeat for every possible 
collidable object in our simulator. 


Above 

An illustration 
of the effect of 
mass on vectors 
in a collision 


QUICK TIP 

We haven't 
used the planet 
graphics or 
much of the user 
interaction code 
that we wrote 
for the solar 
system, but with 
a Little bit of work, 
you should be 
able to drop the 
handleCollisionsO 
function into 
Last issue's code 
and make your 
planets bounce. 
Consider it a 
challenge, if 
you Like. 
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Collbum^y 

01. import pygamOj sys, random, math 

02. import pygame. locals as GAME_GLOBALS 

03. import pygame. event as GAME_EVENTS 

04. import pygame. time as GAME_TIME 

05. 

06. windowWidth = 1024 

07. windowHeight = 768 

08. 

09. pygame. init() 

10. surface = pygame. display. set_mode(( 
windowWidth, windowHeight)) 

11. 

12 . pygame . display . set_caption ( ' Collisions ' ) 

13. 

14. previousMousePosition = [0,0] 

15. mousePosition = None 

16. mouseDown = False 

17. 

18. collidables = [] 

19. currentObject = None 

20. expanding = True 

21. 

22. drawAttractions = False 

23. 

24. gravity = 1.0 

25. 

26. def drawCollidablesO : 

27. 

28. for anObject in collidables: 

29. anObject[ "position" ] [0] += 
anObject ["velocity"] [0] 

30. anObject[ "position" ] [1] += 
anObject[ "velocity"] [1] 

31. 

32. pygame. draw. circle(surface, (255,255,255), 

(int (anObject ["position"] [0] ), 

int ( anOb j ect [ " position "][!])), int ( anOb j ect [ " radius " ] ) , 0) 

33. 

34. def drawCurrentObjectO : 

35. 

36. global expanding, currentObject 

37. 

38. currentObject [ "position"] [0] = mousePosition[0] 

39. currentObject[ "position"] [1] = mousePosition[l] 

40. 

41. if expanding is True and currentObject [ 

"radius"] < 30: 

42. currentObject["radius"] += 0.2 

43. 

44. if currentObject["radius"] >= 30: 

45. expanding = False 

46. currentObject ["radius"] = 9.9 

47. 

48. elif expanding is False and 
currentObject ["radius"] > 1: 

49. currentObject["radius"] -= 0.2 

50. 

51. if currentObject ["radius"] <= 1: 

52. expanding = True 

53. currentObject [ "radius"] =1.1 

54. 

55. currentObject ["mass"] = currentObject ["radius"] 

56. 

57. pygame. draw. circle (surf ace, (255,0,0), 

(int (currentObject ["position"] [0]), 
int(currentObject["position"] [1] )), 

int ( cur rentOb j ect [ " radius " ] ) , 0) 


58. 

59. 

60. 
61. 
62. 

63. 

64. 

65. 

66 . 

67. 


68 . 


69. 

70. 

71. 

72. 

73. 

74. 

75. 

76. 


77. 

78. 

79. 

80. 

81. 

82. 

83. 

84. 


85. 

86 . 

87. 

88 . 

89. 

90. 

91. 

92. 

93. 

94. 

95. 

96. 

97. 

98. 

99. 


def calculateMovementO : 

for anObject in collidables: 

for theOtherObject in collidables: 

if anObject is not theOtherObject: 


direction = 

(theOtherObject[ "position" ] [0] - anObject [ "position"] 
[0], theOtherObject [ "position" ] [1] -anObject [ 

"position"] [1]) 

magnitude = math.hypot( 

theOtherObject[ "position" ] [0] - anObject[ "position" ] [0], 
theOtherObject[ "position" ] [1] - anObject[ "position" ] [1]) 
nDirection = ( 

direction[0] / magnitude, direction[l] / magnitude) 

if magnitude < 5: 

magnitude = 5 
elif magnitude > 15: 
magnitude = 15 

strength = (( 

gravity * anObject["mass"] * theOtherObject["mass"] ) / 
(magnitude * magnitude)) / theOtherObject ["mass"] 

appliedForce = ( 

nDirection[0] * strength, nDirection[l] * strength) 


appliedForce[0] 

appliedForce[l] 


theOtherObject [ "velocity"] [0] -= 
theOtherObject [ "velocity"] [1] -= 


if drawAttractions is True: 
pygame. draw. line( 

surface, (255,255,255), (anObject [ "position" ] 

[0] , anObject [ "position" [1] ) , 

(theOtherObject ["position"] 
[0],theOtherObject["position"] [1]), 1) 


def handleCollisionsO : 


h = 0 


while h < len(collidables) : 
i = 0 


anObject = collidables[h] 
while i < len(collidables) : 

otherObject = collidables [i] 


100. if anObject != otherObject: 

101 . 

102. distance = math. 
hypot(otherObject[ "position" ] [0] - anObject["position"] 

[0] , otherObject[ "position" ] [1] - anObject [ "position"] 

[ 1 ] ) 

103. 

104. if distance < 
otherObject [ "radius"] + anObject [ "radius"] : 

105. 
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106. 

107. 

108. 

109. 

110 . 

111 . 

112 . 

113. 

114. 

115. 

116. 

117. 

118. 

119. 

120 . 
121 . 

122 . 

123. 

124. 

125. 


126. 


127. 

128. 

129. 

130. 

131. 

132. 

133. 

134. 

135. 

136. 

137. 

138. 

139. 


MAKE GAMES WITH PYTHON 


Tutorud 


# First we get the angle of the 140. 

#collision between two objects 141. 

collisionAngle = math. 142. 

atan2(an0bject["position"] [1] - otherObject[ "position"] 143. 

[1], anObject[ "position" ] [0] - otherObject[ "position"] 144. 

[0]) 145. 

146. 

# Then we need to calculate the 147. 

#speed of each object 148. 

anObjectSpeed = math. 149. 

sqrt(anObject[ "velocity"] [0] * anObject["velocity"] [0] + 150. 

anObject["velocity"] [1] * anObject[ "velocity" ] [1] ) 151. 

theOtherObjectSpeed = math. 152. 

sqrt(otherObject[ "velocity"] [0] * otherObject[ "velocity"] 153. 

[0] + otherObject[ "velocity"] [1] * otherObject[ "velocity"] 154. 

[1] ) 155. 

156. 

# NoWj we work out the direction 157. 

# of the objects in radians 158. 

anObjectDirection = math. 159. 

atan2(an0bject[ "velocity"] [1], anObject [ "velocity" ] [0] ) 160. 

theOtherObjectDirection = math. 161. 

atan2(other0bject[ "velocity"] [1], otherObject[ "velocity"] 162. 

[0]) 163. 

164. 

# Now calculate new X/Y values 165. 

# of each object for collision 166. 

anObjectsNewVelocityX 167. 

= anObjectSpeed * math. cos (anObjectDirection - 168. 

collisionAngle) 169. 

anObjectsNewVelocityY 170. 

= anObjectSpeed * math. sin(anObjectDirection - 171. 

collisionAngle) 172. 

173. 

otherObjectsNewVelocityX = 174. 

theOtherObjectSpeed * math. cos (theOtherObjectDirection - 175. 

collisionAngle) 176. 

otherObjectsNewVelocityY = 177. 

theOtherObjectSpeed * math. sin (theOtherObjectDirection - 178. 

collisionAngle) 179. 

180. 

# We adjust the velocity based 181. 

# on the mass of the objects 182. 

anObjectsFinalVelocityX 183. 

= ((anObject["mass"] - otherObject["mass"] ) * 184. 

anObjectsNewVelocityX + (otherObject["mass"] + 185. 

otherObject["mass"] ) * otherObjectsNewVelocityX)/ 186. 

(anObject ["mass"] + otherObject[ "mass" ] ) 187. 

otherObjectsFinalVelocityX 188. 

= ((anObject["mass"] + anObject["mass"]) * 189. 

anObjectsNewVelocityX + (otherObject[ "mass" ] - 190. 

anObject["mass"] ) * otherObjectsNewVelocityX)/ 191. 

(anObject["mass"] + otherObject["mass"] ) 192. 

# Now we set those values 

anObject[ "velocity" ] [0] = 193. 

anObjectsFinalVelocityX 194. 

otherObject[ "velocity" ] [0] = 

OtherObjectsFinalVelocityX 195. 

196. 

i += 1 197. 

198. 

h += 1 199. 

def handleMouseDownO : 200. 

global currentObject 201. 

202. 


currentObject = { 

"radius" : 3j 
"mass" : 3j 
"velocity" : [0,0] j 
"position" : [0,0] 

} 

def quitGame(): 
pygame.quitO 
sys.exitO 

# 'main' loop 
while True: 

surf ace. fill ( (0,0,0)) 
mousePosition = pygame. mouse. get_pos() 

# Handle user and system events 
for event in GAME_EVENTS.get() : 

if event. type == pygame. KEYDOWN: 

if event. key == pygame. K_ESCAPE: 
quitGameO 

if event. type == pygame. KEYUP: 

if event. key == pygame. K_r: 

collidables = [] 
if event. key == pygame. K_a: 

if drawAttractions is True: 

drawAttractions = False 
elif drawAttractions is False: 
drawAttractions = True 

if event. type == pygame. MOUSEBUTTONDOWN: 
mouseDown = True 
handleMouseDown ( ) 

if event. type == pygame. MOUSEBUTTONUP: 
mouseDown = False 

if event. type == GAME_GLOBALS.QUIT: 
quitGameO 

calculateMovementO 

handleCollisionsO 

drawCollidablesO 

if currentObject is not None: 
drawCurrentObjectO 

# If our user has released the mouse, add the new 

# anObject to the collidables list and let gravity 

# do its thing 

if mouseDown is False: 

currentObject[ "velocity"] [0] = 
(mousePosition[0] - previousMousePosition[0] ) / 4 
currentObject ["velocity"] [1] = 
(mousePosition[l] - previousMousePosition[l] ) / 4 
collidables .append (currentObject) 
currentObject = None 

# Store the previous mouse coordinates to create a 

# vector when we release a new anObject 
previousMousePosition = mousePosition 

pygame . display . update ( ) 


>PYTH0N 
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WILLIAM BELL 

Will is a previous contributing editor on 
The MagPi before it became the official 
Raspberry Pi magazine. Will enjoys solving 
complicated problems with elegant, 
bespoke solutions. For him, the bigger the 
challenge, the bigger the attraction. 
whbeLL.net 


BUILD A 

SPACE SHOOTER 
IN SCRATCH 


William H Bell walks us through how to create an impressive 3D space shooter using 
nothing more than Scratch and some clever coding techniques... 


© cratch is a great programming language 

for testing out a range of concepts. Scratch 
programs typically involve controlling one or 
more sprites on the screen. Computer games where 
the characters are controlled from a distant view are 
third-person games. Games can be more exciting 
when the human player looks through the eyes of 
the central character in the game, however. This is 
normally referred to as a first-person game. 

In this article, some of the principles of constructing 
a first-person game are introduced. The player is the 
pilot of a spaceship that is drifting through a debris 
field. The main engine has gone offline, causing the 
spaceship to drift through the debris at a constant 
speed. However, the spaceship still has working 
thrusters on the top, bottom, left and right of the 


Right Hit the 
space bar to fire 
the ship’s lasers to 
destroy debris; if it 
crashes into you, 
your shield (green 
bar) will deplete 


craft. The main laser system is also operational. The 
heroic pilot has to shoot through or dodge the debris. 
A point is awarded each time a piece of debris is 
destroyed with the ship’s lasers. If the debris crashes 
into the spacecraft, then the shield of the spacecraft 
will be damaged. After the shield has been completely 
broken, the spacecraft will explode. 

Perspective 

In real life, objects that are far away appear to be 
smaller. One example of this is a set of railway tracks. 
Looking down railway tracks and into the distance, 
the tracks appear to become closer together. This can 
be applied to a computer game, where objects need 
to be shown as being in the distance. When an object 
becomes closer to a player, the object should become 
larger on the screen. 

In this game, a one-point perspective is used. This 
means that distant objects appear to come from the 
centre of the screen. Rather than draw a lot of very small 
images at the vanishing point, it is more sensible to 
assume a viewing plane. The viewing plane corresponds 
to the distance at which objects become visible. The two 
diagrams at the top-left of page 65 show the vanishing 
point as it appears on the screen, and the position of the 
viewing plane. In the illustration of the viewing plane, 
the z-axis points from the centre of the screen straight 
towards the player and is perpendicular to the x-y plane. 

If the spacecraft has no velocity along the x-y plane 
and an object appears at the viewing plane with a 
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The view from the cockpit 
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go to front 


switch to costorr 

le WorkingShip 

go to x^ 0 y: 0 




set shieldLeft t 


set score to Q 

w/M 

wait untH shielc 

iLeft <C 0 j 

switch to costiim^ 

e Destroyed 




These code blocks set the 
four main variables and 
control the spacecraft’s 
movement (via cursor keys) 


when left ’^VrovlQj key pres^^ed 
■f $htek 

change v> 



when riQht irrov ‘ key pressed 
if shield Left 
change vx 

stop script 




when up arrot? j key pressed 
if shieldLeft > 

change by 

stop script 



fl 


In the game, the spacecraft is not able to turn. Since 
the stars in the distance are very far away, they 
would not appear to move relative to the spacecraft 


position that is not in the centre of the screen, then the 
object appears to have a velocity that is proportional to 
its distance from the centre of the screen. This is not 
a real velocity, but is the effect of the perspective used 
to display the z-axis. This effect can be observed when 
driving along a straight road: a vehicle that is on the 
other side of the road, but far in the distance, appears 
to move to the other side of the road as it approaches. 

Spaceship and star field 

In the game, the spacecraft is not able to turn. Since the 
stars in the distance are very far away, they would not 
appear to move relative to the spacecraft. Therefore, 
a static star field was drawn on the stage background. 

The spaceship cockpit and heads-up display should 
stay in the foreground. This was achieved by creating 
a sprite that is as big as the screen. When the game 
starts, the Spaceship sprite is set to be above other 
sprites. Therefore, the cockpit edges are displayed as 
being in the foreground. 

The horizontal and vertical velocity components 
of the spacecraft are stored in the vx and vy variables. 
These variables were created as global variables, since 


the velocity components affect the motion of other 
sprites on the screen. The shieldLeft variable 
contains the number of shield points left, and the 
score contains the player’s score. The shieldLeft 
variable was created as a global variable, since the 
other sprites that may hit the cockpit need to be 
able to change its value; score was also created as 
a global variable, since other sprites need to be able 
to increment it. The game continues until there are 
no shield points left. When the game starts, all four 
global variables are reset to zero and the spaceship is 
shown to be working as normal. If there are no shield 
points left, then the ship is shown to be destroyed by 
changing the costume of the Spaceship sprite. The 
thrusters on the right, left, bottom and top of the 
spacecraft are controlled by the cursor keys. Since 
the spacecraft is in space, there is no friction to slow 
down its movement. Therefore, firing the thrusters 
in one direction will build up the velocity in that 
direction. To make it easier for the player to see the 
current status of the game, the values of the vx, vy 
and score variables were selected to be displayed at 
the bottom of the screen. 
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Right Each 
costume is used 
for one of four 
shield states 


go to front J 
go back Q layers j 
switch to costume Shields 
go to x: 0 y: 0j 
wait until shieldLeft Q 

switch to costume Shields 
wait until shieldLeft Q 

switch to costume Shieldl 
wait until shieldLeft : Q 
switch to costume NoShield 
stop script] 


Lasers 

The lasers were drawn as another sprite. The size 
of the Laser sprite was carefully matched to the 
Spaceship sprite by copying the Spaceship costume 
to check where the lasers would appear on the screen. 

When the green flag is pressed, the Laser sprite 
is set to appear just below the Spaceship sprite. 
Therefore, it is in the foreground but not as close as 
the cockpit. The lasers are fired by pressing the space 
bar. To make the game a little bit harder, the lasers 
fire for a second and then recharge for a second. This 
means that the player should not hold down the space 
bar, but only fire the lasers when needed. Similar to 
the Spaceship sprite script, the Laser sprite only 
recognises the space bar when the number of shield 
points is greater than zero. 


Shield heads-up display 

The number of shield points remaining is shown 
on the left-hand side of the screen. This image is a 
sprite called Shield, which has several costumes that 
correspond to the different shield states. The different 
costumes were a copy of the first costume, each with 
one more green box removed. 


Space debris 

Two types of space debris were created: LavaBall and 
Scrap. The script for the LavaBall sprite was copied 
and modified slightly for the Scrap sprite to prevent 
both sprites appearing at exactly the same time. The 
two sprites were also given two costumes, to show 
them as being normal or exploded. 


II 


The script for the LavaBall sprite was copied and 
modified slightly for the Scrap sprite to prevent 
both sprites appearing at exactly the same time 


II 


When the green flag is pressed, the Shield sprite 
is set to be just below the main cockpit but above the 
other sprites. This means that the shield display stays 
Below These in the foreground. The script for the Shield sprite 

blocks implement until the number of shield points decreases and 

the firing of the ^ 

spacecraft’s laser then switches to the appropriate costume. 



When the green flag is pressed, the LavaBall is 
placed below the cockpit, shield display, and lasers. 
Then it is hidden from view. The main loop continues 
while the game is being played. When the Spaceship 
sprite switches to the destroyed costume, it finishes 
the game by stopping all scripts. This includes the 
main loops of the space debris sprites. 

To show that it is in the distance, the LavaBall 
appears at the viewing plane at i% of its normal size. 
To make the game more interesting, its starting 
position is chosen at random in the x-y plane. Due 
to the one-point perspective used, objects that are 
closer to the edge of the screen will quickly disappear 
from this location. Therefore, objects were chosen 
to appear within a lOO by lOO box around the centre 
of the screen. The initial position of the sprite, along 
the X- and y-axes, is stored in the initial_x and 
initial_y variables. Since these variables are only 
needed for this sprite, they were created as local 
variables for this sprite only. The initial position 
components are rescaled to produce an apparent 
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velocity offset associated with the perspective. They are 
rounded to integers, since the sprite moves in numbers 
of pixels. The sprite is then shown on the screen. Next, 
the script enters another loop that continues until the 
sprite is full-size, has touched the edge of the screen, 
or has been hit by the laser beams. The point where the 
two laser beams meet was given a pink colour, so that 
this colour could be used to test if the laser beams had 
hit the LavaBall. The relative velocity of the debris 
along the z-axis can be raised by increasing the change 
size by 5 (5%) command or by reducing the size of 
the wait within the motion loop. 

In this game, the space debris is spinning but is 
otherwise stationary with respect to the rest of the 
universe. The spacecraft is drifting through the debris 
field at a constant speed, and starts the game at rest 
in the x-y plane. When the spacecraft thrusters are 
fired, the spacecraft moves along the x-y plane with 
respect to the universe. However, the game is played 
from the pilot’s point of view, rather than from the 
point of view of the universe or the space debris. 
Therefore, when the player’s spacecraft is moving 
to the left, the LavaBall is shown as moving to the 
right. If the spacecraft moves downwards, then the 
LavaBall moves upwards. This can be demonstrated 
by looking at a cup on a desk: if the person looking at 
the cup moves to the left, then the cup moves to the 
right with respect to the person’s line of sight. The 
motion of the sprite is therefore the sum of the relative 
velocity and the apparent velocity, due to the object 
being created at a point on the viewing plane that 
is not in the centre of the screen. 

If the LavaBall has been hit by the laser beams, 
then the score is incremented and the costume is 
switched to the exploded version. The program 
waits for half a second for the player to view the 
exploded sprite. If the LavaBall has not been hit 
by the lasers and it has not touched the edge of the 
screen, then it has hit the spacecraft. If the LavaBall 
has hit the spacecraft, then the number of shield 
points is reduced by one and the LavaBall costume 
is switched to the exploded version. If the LavaBall 
has missed the spacecraft, then it disappears 
behind the spacecraft harmlessly. After these 
logic conditions, the LavaBall sprite is hidden and 
reappears somewhere else on the screen. 

Possible extensions 

Other features could be added to the game. The 
spacecraft could collect shield tokens or be able to use 
a wider laser beam to destroy more than one object 
at once. Alternatively, the principles demonstrated 
within this program could be used to create a first- 
person car racing game. 
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Tutorial 


WALKTHROUGH 

tt))) Sonic Pi 



SAM AARON 

Sam is the creator of Sonic Pi. By day he's 
a research associate at the University of 
Cambridge, and by night he writes code for 
people to dance to. 

sonic-pi.net 


CODED BEATS 


^ouU 

Heed 

> Raspberry Pi 
running Raspbian 

> Sonic Pi V2.6+ 

> Speakers or 
headphones with 
a 3.5mm jack 

> Update Sonic Pi: 

sudo apt-get 
update && sudo 
apt-get install 
sonic-pi , 


Sonic Pi creator Sam Aaron continues his essential new series 
with one of the most influential drum breaks in music history... 


O ne of the most exciting and revolutionary 
technical developments in modern music 
was the invention of computer-based 
samplers in the late 1970s. These electronic boxes 
of tricks allowed you to record any sound into them 
and then manipulate and play back those sounds in 
many interesting ways. For example, you could take 
an old record, find a drum solo (or break), record it 
into your sampler, and then play it back on repeat at 
half-speed to provide the foundation for your latest 
beats. This is how early hip-hop music was born, 
and today it’s almost impossible to find electronic 
music that doesn’t incorporate samples of some 
kind. Using samples is a really great way of easily 
introducing new and interesting elements into your 
live-coded performances. 

So where can you get a sampler? Well, you already 
have one: it’s your Raspberry Pi! The built-in live- 
coding app Sonic Pi has an extremely powerful 
sampler built into its core. Let’s play with it! 

The Amen Break 

One classic and immediately recognisable drum 
break sample is called the Amen Break. It was first 
performed in 1969 in the song Amen Brother by The 
Winstons, as part of a drum break. However, it was 
when it was discovered and sampled by early hip-hop 
musicians in the 1980s that it started being heavily 
used in a wide variety of other musical styles such 
as drum and bass, breakbeat, hardcore techno, 
and breakcore. 

I’m sure you’re excited to hear that it’s also built 
right into Sonic Pi. Clear up a buffer and throw in the 
following code: 

sample :loop_amen 

Hit Run and boom! You’re listening to one of the 
most influential drum breaks in the history of dance 
music. However, this sample wasn’t famous for being 
played as a one-shot: it was built for being looped. 


Beat stretching 

Let’s loop the Amen Break by using our old friend the 
live_loop, introduced in last month’s tutorial: 

live_loop :amen_break do 
sample :loop_amen 
sleep 2 
end 

OK, so it is looping, but there’s an annoying 
pause every time round. That is because we asked 
it to sleep for 2 beats; however, with the default 
BPM of 60, the : loop_amen sample only lasts 
for 1.753 beats. We therefore have a silence of 
2 - 1.753 = 0.247 beats. Even though it’s short, 
it’s still noticeable. 

To fix this issue, we can use the beat_stretch : 
opt to ask Sonic Pi to stretch (or shrink) the sample 
to match the specified number of beats. 


live_loop :amen_break do 

sample :loop_amen, beat_stretch : 2 
sleep 2 
end 

Now we’re dancing! Although, perhaps we want 
speed it up or slow it down to suit the mood. 

Playing with time 

OK, so what if we want to change styles to old-school 
hip-hop or breakcore? One simple way of doing this 
is to play with time or, in other words, to mess with 
the tempo. This is super-easy in Sonic Pi: just throw 
a use_bpm into your live loop... 


Sonic Pi^s sample and synth functions give you 
a lot of control via optional parameters such as 
amp : , cutoff : , and release : . However, 
the term ‘optional parameter^ is a real 
mouthful, so we just call them opts to keep 
things nice and simple. 
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live_loop :amen_break do 
use_bpm 30 

sample :loop_amen, beat_stretch: 2 
sleep 2 
end 

Whilst you’re rapping over those slow beats, notice 
that we’re still sleeping for 2 and our BPM is 30, yet 
everything is in time. The beat_st retch opt works with 
the current BPM to make sure everything just works. 

Now, here’s the fun part. Whilst the loop is still live, 
change the 30 in the use_bpm 30 line to 50. Whoa, 
everything just got faster yet kept in time! Try going 
faster: up to 80 . . . to 120 . . . now go crazy and punch in 200 1 

Filtering 

Now we can live-loop samples, let’s look at some 
of the most fun opts provided by the sample synth. 
First up is cutoff : , which controls the cutoff filter 
of the sampler. This is disabled by default, but you can 
easily turn it on: 

live_loop :amen_break do 
use_bpm 50 

sample :loop_amen, beat_stretch: 2, 
cutoff: 70 
sleep 2 
end 

Go ahead and change the cutoff: opt. For example, 
increase it to 100, hit Run, and wait for the loop to 
cycle round to hear the change in the sound. Notice 
that low values like 50 sound mellow and bassy, and 
high values like 100 and 120 are more full-sounding 
and raspy. This is because the cutoff: opt will chop 
out the high-frequency parts of the sound, just like 
a lawnmower chops off the top of the grass. The 
cutoff: opt is like the length setting, determining 
how much grass is left over. 

Slicing 

Another great tool to play with is the sheer FX. This 
will chop (slice) the sound up. Wrap the sample line 
with the FX code like this: 

live_loop :amen_break do 
use_bpm 50 

with_fx :slicer, phase: 0.25, wave: 0, 
mix: 1 do 

sample :loop_amen, beat_stretch : 2, 
cutoff: 100 
end 

sleep 2 
end 

Notice how the sound bounces up and down a little 
more. (You can hear the original sound without the 
FX by changing the mix: opt to 0). Now, try playing 


SONIC PI LIVE CODING 


around with the phase : opt. This is the rate (in beats) 
of the slicing effect. A smaller value like 0.125 will 
sheer faster and larger values like 0 . 5 will slice more 
slowly. Notice that successively halving or doubling 
the phase: opt value tends to always sound good. 
Finally, change the wave : opt to one of 0, 1, or 2 and 
hear how it changes the sound. These are the various 
wave shapes. 0 is a saw wave, (hard in, fade out), 1 is 
a square wave (hard in, hard out), and 2 is a triangle 
wave (fade in, fade out). 


>RUBY 



LeftTheAkaiMPC 
2000. a classic 
early sampler 


Bringing it all together 

Finally, let’s revisit the early Bristol drum and bass 
scene. Don’t worry too much about what all this code 
means; just type it in, hit Run, then start live-coding it 
by changing opt numbers and see where you can take 
it. Please do share what you create! See you next time. . . 


use_bpm 90 
use_debug false 
live_loop :amen_break do 

p = [0.125, 0.25, 0.5]. choose 

with_fx :slicer, phase: p, wave: 0, mix: rrand(0.7, 1), 
reps: 4 do 

r = [1, 1, 1, -1]. choose 

sample :loop_amen, beat_stretch: 2, rate: r , amp: 2 
sleep 2 
end 
end 

live_loop :bass_drum do 

sample :bd_haus, cutoff: 70, amp: 1.5 
sleep 0.5 
end 


live_loop : landing do 

bass_line = (knit :el, 3, [:cl, :c2]. choose, 1) 
with_fx :slicer, phase: [0.25, 0.5] .choose, invert_wave: 1, 
wave: 0 do 

s = synth : square, note: bass_line.tick, sustain: 4, 
cutoff: 60 

control s, cutoff_slide: 4, cutoff: 120 
end 

sleep 4 
end 
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CLOUD 
RESEARCH 
IN MINIATURE 


Think “cloud” and youTl picture massive data centres, but a Pi 2 cluster is just 
the thing to model cloud computing for affordable computer science research 



Below The Pi 
cluster’s Lego case 
was assembled 
by biscuit-fuelled 
volunteers! 


® oore’s law, describing 
exponential growth in 
computing power, has held 
good for 50 years now, but while 
processors continue to become 
more powerful, speeds have not 
increased. Rather, the number 
of processor cores crammed 
into each chip has grown, and 
programmers are still catching 
up with writing programs that run 
well across multiple cores, CPUs, 
and individual machines. 

Concurrent programming, 
coming together with virtualisation 
in the data centre, and applications 
distributed through cloud 
computing, has opened up vast 
new areas of research for computer 
scientists. Can there really be a 
serious role for the tiny Raspberry 
Pi in this field? 



Scale model 

Dr Posco Tso, a lecturer in 
the School of Computing and 
Mathematical Sciences at Liverpool 
John Moores University (LJMU), 
is researching cloud computing 
and big data processing, but ran 
up against the limitations of 
modelling clusters in software. 

Data centres are expensive beasts: 
Microsoft’s $500m data centre in 
Dublin, and Google’s $6oom Iowa 
centre are at the cheaper end of 
the scale, with Apple’s latest data 
centre costing the company $ibn. 
The affordable answer is to build a 
scale model, and the Pi is certainly 
affordable, as well as being small 
enough to even look like a scale 
model of a computer! 

In 2013, while working at 
Glasgow University before moving 
to LJMU, Posco started with a 56- 
node cluster of Raspberry Pi Model 
B+ boards. Theses single-core 
boards were most restricted by 
low RAM, and weren’t ideal for big 


data research. ^^Results were 
disappointing with B+,” Posco 
tells us, with output 1,000 times 
less, at 0.1% of an Intel iy chip. 

The first cluster did give some 
useful results in comparing 
throughput between different 
workloads, and the B+ running 
80 (idle) web servers in parallel 
showed the low overhead of 
Docker containers (see ^Docker 
on Pi’ box on page 73). The Pi 
was ^^exciting, but still a toy.” 

When the Pi 2 appeared 
earlier this year, Posco, now in 
Liverpool, rigged up a test array 
of 14 for a simple Apache Spark 
setup, in standalone cluster 
mode (see ^Apache Spark’ 
box), with promising results: 

^ht renewed my hope to carry 
on research on it,” he says. 
Posco had a ^^positive feeling” 
about results with Apache 
Spark, which were encouraging 
enough for him to commission 
the current yo-board cluster. 
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APACHE SPARK 

Join dozens of computers together and you 
will need cluster management software to 
share your tasks out among the individual 
nodes. Of all the choices available - for there 
are many - Apache Spark is ideally suited to 
the Pi: Spark caches datasets in-memory, 
something that has seen it measured at up to 
one hundred times faster than the competition 
for some tasks. 

For the Pi 2, with iGB of RAM being just 
enough for Spark, the in-memory primitives 
free it from the relative slowness of the disk 
interface, and other architectural limitations. 
Data is shared across nodes in Resilient 
Distributed Datasets (RDDs), and transformed 
with map, filter, reduce, or Join operations - 
programmed in Python, Scala or Java, through 


feature 


CLOUD RESEARCH IN MINIATURE 


Below Could Raspberry Pi clusters prove a 
useful tool for big data work? 


This was made up of a mix of Pi 2 
boards and B+ Pis, until enough 
Pi 2s were sourced. One bug being 
puzzled over is that, of the four 
cores, ^^one is always idle.’^ 
Research is also continuing 
with a Pi 2 cluster at Glasgow 
University, and between the two 
institutions, there exists the 
world’s first distributed Raspberry 
Pi 2 cloud. At both universities, 
the Pi cluster serves the twin 
purposes of teaching and research, 
as students ^^create their own 
platform for virtualisation. ” 


x86 hardware, without also having 
to take account of bottlenecks 
in virtualisation: during early 
benchmarking a 30% loss measured 
in iperf (a network testing tool) 
at 70MB/S was put down to the 
virtualisation software. The 
virtualisation overhead with ikB 
data size was a 68% loss. 

Benchmarking with httperf with 
different sets of workloads showed 
the Pi 2 performing up to 100 
times better than a B+. In a cloud, 
or data centre full of small VMs, 
these are the kind of throughputs 


the Spark API (application program interface) - 


producing new RDDs. 

L 


Looking at software-defined 
networking, Posco’s team is 
working towards ^The big goal,” 
modelling for a future ^^five million 
Pis” or other small ARM boards 
in data centres. ^^You could call 
us ambitious,” says Posco, with 
admirable understatement. Yet the 
challenges of cooling current data- 
centre processors, and generating 
and paying for enough electricity 



One cloud, many 
(research) angles 

With his interest in cloud data- 
centre resource management, 
Posco’ s Pi researches have 
naturally targeted KVM, Xen, 
and LXC, then OpenStack, the free 
software cluster framework. Early 
work with Docker is continuing at 
the Glasgow end of the project, but 
in Liverpool they’re now modelling 
data-centre clusters with one 
Pi per node, directly modelling 
a Pi 2 against a conventional 
data-centre virtual machine (VM). 

This only removes a small 
overhead, but the real gain is 
simplifying modelling, as any 
bottlenecks in, for example. Spark 
processing can be explored for 
Pi-specific problems, or examined 
to see if they are just a function 
of the software’s optimisation for 


I Between the two institutions, there 
exists the world's first distributed 
Raspberry Pi 2 cloud 


II 


which can be common, as 
database queries, and webpages 
and images, are served. Posco 
is also looking to ^^move from 
cloud to fog: real-time microdata 
mining.” Current research in 
network function optimisation 
from the team may help here, 
particularly in the future growth 
of big data on ARM, and general 
data-centre use, as concerns 
over power consumption make 
ARM chips potentially far more 
attractive than power-hungry 
Intel processors. 


for future data centres, has many 
predicting huge growth for ARM- 
powered servers. 

As we go to press, many in the 
research community are gearing 
up for ParCo20i5 in Edinburgh, 
where parallel computing 
researchers will be presenting 
results from FPGAs, GPUs, and 
other lower-power hardware. 
Smaller processors are no longer 
confined to the embedded space, 
and more resources should soon 
see optimisation of data-centre 
software for non-Intel platforms. 
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VIRTUAL 

PARA-HYPER-VISOR-ISATIQN? 

Full virtualisation emulates an entire hardware 
platform, enabling, for example, a virtual Raspberry 
Pi ARM v 7 system to run on your 64-bit laptop. 

The hypervisor - the software (or firmware, or 
even hardware) that creates and runs the virtual 
machines - emulates every aspect of CPU 
instructions, disk access, even starting BIOS in 16-bit 
legacy mode on PCs. 

The guest operating system (OS) will run slightly 
slower, as everything must be translated by the 
hypervisor. Modified guest OSs can make calls 
directly to the hypervisor to speed things up, rather 
than running simulated machine I/O instructions; 
this is known as paravirtualisation (PV). 

Hardware-assisted virtualisation, also known 
as accelerated virtualisation, refers to a set of 
hardware extensions in the CPU to make it simpler 
to virtualise the processor. Xen hypervisor, running 
these instructions, calls this a hardware virtual 
machine (HVM), and supports combinations of HVM 
with PV drivers. 

Lastly, operating-system-level virtualisation 
allows direct system calls to the OS kernel 
from multiple, isolated VM-Uke containers, all 
sharing the same underlying kernel. OpenVZ is 
a popular example of this, often found in web 
hosting services to provide VMs, while Docker is 
a layer of abstraction around containers to make 
them easy to deploy. Linux also has its own KVM 
(Kernel-based Virtual Machine), which provides 
virtualisation infrastructure. 

L ^ 



Right You need 
a cheerful 
disposition, 
like intern Jim 
Walker, to 
take software 
problems in 
your stride 



PayPal is an early adopter of 
(64-bit) ARM in the data centre, 
looking to save more than 80% 
in running costs with low energy 
consumption chips from Applied 
Micro. Qualcomm has announced it 
is entering the data-centre market 
later this year, too, with a new 64- 
bit ARM chip designed for servers. 

Lego cose 

Back at the scale model end 
of computing, the original Pi 
cluster attracted some attention 
because of its Lego case, which 
was assembled cheaply by 
biscuit-fuelled volunteers (biscuit 
budget: £5!). ^^When we lifted 
it, it fell apart, Posco tells 
us, ^^because of the weight of 
the cables.’^ A 3D-printed case 
has been developed, optimised 
for ^^minimal amount of 
material,’^ ventilation, and the 
boards being ^^easy to slide out 
for maintenance.’’ 

There is a lot of cabling, and 
a substantial amount of current 
flowing at five volts, required 
to make a 70-board cluster. 

In Glasgow’s cluster of 14 Pi 2s, 
they’ve now moved to Lego again, 
to ease hot-swapping of boards, 
and access to the HDMl port, 
^^making network troubleshooting 
just that little bit quicker,” 
according to intern Jim Walker. 

No Intel 

New users of Raspbian on the Pi, 
and the similarly Debian-based 
Ubuntu on laptops and PCs, are 
often surprised by how seamless 
installation of lots of new software 


is. However, a lot of work and 
testing - by Debian developers, 
Ubuntu and Raspbian developers, 
and downstream users who run 
the pre-releases - produces these 
(mostly flawless) results. 

If you’re making your way 
down a software path which 
is less trodden, be prepared to 
do more than a little legwork: 
putting error messages into search 
machines, editing configuration 
files, recompiling software. For 
32-bit ARM V7, you’re a long way 
from the mainstream for cloud 
research, and getting hypervisors 
and paravirtualisation software 
(see Wirtual Para-hyper-visor- 
isation?’ box) up and running isn’t 
always the one-step install of the 
Intel x86 and AMD64 architectures. 

Posco’ s team’s blogs are full of 
posts detailing workarounds - left 
to help the next person stumped 
by an error message, and throwing 
themselves on the mercy of the 
search engine gods - on topics 
including problems on the team’s 
standard PCs as well. An example is 
getting httperf to work on Ubuntu, 
for benchmarking the cluster 
under various HTTP workloads (to 
measure the throughput of the 
cluster, and see what size of data 
the tiny Pi works best with). A 
standard installation throws errors 
about FD_SETS 1 ZE; fixing involves 
changing limits, then building a 
fresh version from source code. 

Logical Volume Manager (LVM) 
enables adding more disks and 
collecting together partitions 
of several disks as one virtual 
partition. While the Pi typically 
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has an SD card, and perhaps a USB 
drive for data, working with big 
data can involve large collections 
of disks, and the need to hot- 
swap if there’s a problem. LVM 
makes it straightforward; what it 
doesn’t like is a virtual machine 
installed on a disk partition, as 
this involves logical partitions 
within logical partitions. So, to 
run Xen hypervisor successfully, 
a logical volume must be created 
for each of the VM’s partitions; 
now they can be formatted and 
mounted successfully. 

Summer in Glasgow 

Glasgow intern Jim Walker is 
spending the summer preparing 
the 14-node Pi 2 setup for Docker 
cluster managed with SaltStack, 
recently announcing ^‘creating 
the first (a scoop! The first!) 

ARM Docker Hadoop image 
and Dockerfile,” and writing 


shiny or new are good reasons for 
updating software.” 

We can’t argue with that, but do 
reflect that the motto for many in 
the maker and hacker community 
is Tix it till it breaks’! Walker has 
also started updating the Twitter 
account for the Scottish end 
of the project - you can follow 
developments at @glasgowpicloud 
- and the Glasgow Pi 2 cloud may 
be on a tour of events this autumn. 

Future cluster 

Everywhere, the team is coming 
up against the problems of Intel 
bias in design decisions. The 
OpenStack software is billed as 
cross-platform, but is inefficient 
on ARM due to x86 optimisations. 
With default 64MB data chunks 
in the Spark tests, the Pi showed 
itself GPU-bound. ^^One way for Pi 
to perform better is decrease the 
data chunk size,” says Posco, but 


I Jim Walker is spending the 
summer preparing the 14- 
node Pi 2 setup for Docker 


with good-natured humour on 
those challenges of the road less 
travelled in software. After a 
Docker update to a version that 
didn’t support ARM, Walker found 
the previous Arch Linux version 
of Docker unarchived, and had to 
build his own, only to find a fixed 
Docker was released the next day. 

Reflecting on the necessity for 
updates, he writes: ^Jt doesn’t 
exist. Updates are a swindle and a 
lie. If a system is working, don’t 
change it. Don’t, for example, 
command all your nodes to update 
their most vital piece of software 
when there is absolutely no need 
for it. 1 really recommend that if 
you think that your machines do 
need some shiny new software, 
please find a good reason for 
updating it, and then make sure 
you test it. Please note that neither 


benchmarking must initially be 
done with out-of-the-box settings, 
for proper academic comparison. 

The Pi itself has limitations, 
it must be admitted: ^^The next- 
generation Pi needs better 
networking,” Posco reckons. The 
benchmark from lOOkB data size - 
20% GPU, 80% idle - tells us the Pi 
is ^dimited by the network.” 

With plans to build a 200-board 
cluster next, entirely made of 
Pi 2s, Posco should be getting 
benchmarks indicating how 
suitable the Raspberry Pi is for 
some serious big data work, for a 
power consumption and purchase 
cost comparable to just a handful of 
rack- mounted Intel-based servers. 

Since the LJMU / Glasgow 
cluster started, several other Pi 
clusters projects have appeared, 
many focused on cloud computing 


DOCKER ON PI 

Docker images are available for 64-bit PCs, and 
32-bit is unsupported - although many users have 
built it for themselves - but it is available for 32-bit 
ARM. in particular the Raspberry Pi, and the Pi 2’s 
four cores make containerisation a tempting project 
for any Pi user. 

Docker is loved by developers for freeing them 
from dependency problems, by expressing a series 
of commands to build each container (see examples 
at docker.com). However, the Docker system starts 
with a core image: this must be an ARM vy image 
to run on Raspberry Pi so, effectively, you have to 
develop on a Pi. Fortunately, the quad-core Pi 2 is 
speedy enough to make this manageable, if not 
exactly swift. 

Running Raspbian, you won’t find Docker in your 
repository, but change your SD card for one with 
Arch Linux or Ubuntu and you will; hypriot.com also 
has pre-built images with Docker. The advantage 
of using Arch Linux is that it is by default a fairly 
minimal installation, so all the Pi’s precious system 
resources can be put into running Docker containers 
and their contents. 

L 


research, and even GGHQ, the UK 
government’s Signals Intelligence, 
building a rather neat one (with 
Power-over-Ethernet to reduce 
cabling), to ^hnspire schoolchildren 
and students to take up science, 
technology, engineering and maths 
(STEM) subjects.” 

With ARM in the data centre set 
for massive growth in the next few 
years, cluster tools and infrastructure 
for the Pi will get better, and we look 
forward to hearing more from Posco 
and his team on the Pi’s suitability 
for big data work. 

Below Dr Posco Tso 
holding one little board 
with many applications 
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YOUR QUESTIONS ANSWEREO 


FREQUENTLY 

ASKED 
QUESTIONS 


Your technical hardware and software problems solved 


NEED A 
PROBLEM 
SOLVED? 

Email magpi@raspberrvpi.org or 
find us on raspbGrrvpi.org/forums i 

to feature in a future issue. 



A HAT FOR ANY OCCASION 



I understand that you can now get HAT add-on 
boards for the Raspberry Pi that just fit on top of 
it, rather than being attached by a standard ribbon 
cable. Please could you tell me whether these will 
work with any Raspberry Pi model? And do you need 
to remove the Pi from its case in order to plug in the 
HAT? Also, do you have any suggestions as to which 
HATs a newcomer like me might get started with? 
David Wood 


The HAT (Hardware Attached on Top) specification 
was introduced by the Raspberry Pi Foundation last 
year, aiming to make add-on boards much easier 
to use: each plug-and-play HAT supports a special 
autoconfiguration system that allows automatic GPIO 
and driver setup. Most HATs are compatible with the 
Pi Model A+, B+ and 2, although you should double- 
check with the supplier first. While not all cases will 
enable you to connect a HAT, the official Raspberry Pi 
case features a removable lid for easy access; another 
good option is the Pibow Coupe. 

Which HAT to get started with? Well, it really 
depends what kind of project you want to do. The 
Unicorn HAT is a fun one, featuring a grid of coloured 
LEDs to program. If you fancy something musical, 
the Piano HAT (based on Zachary Igielman’s PiPiano) 
has a mini keyboard. Other HATs, such 
as the Explorer, are ideal for 
electronics and robotics 
projects. Check out 

retail sites such as 
Pimoroni, 
The Pi 
Hut and 
Adafruit 
to peruse 
a wide 

range of HATs 
and pick one 
that fits! 
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FROM THE RASPBERRY PI FAQ 

RASPBERRYPI.ORG/HELP 


How do I change the password for my Raspberry Pi? 

It’s actually very simple. In a terminal, type passwd. 

You’ll be prompted for the current password (the default 
in Raspbian is ‘raspberry’). After that, enter the new 
password, retype it and you’ll get a message saying that 
it’s been updated. 


to expand the file space used so that the root partition 
takes up the entire space available on the SD card - not 
just the size of the original image. To do this, go to the 
Raspi-config menu (by entering sudo raspi-config in a 
terminal) and choose the 'expand_rootfs’ option. 


Can I use Adobe Flash Player on the Raspberry Pi? 

Since Adobe has opted not to support any devices with 
the kind of ARM CPU used by the Pi, the official answer 
is no. However, there is a workaround involving the 
Chromium browser and a Pepper Flash Player plugin. 
See bit.ly/iNaJOmo for instructions. It might not work 
perfectly on every website, but we were able to play 
some Flash games and animations. 

I put Raspbian on a i6GB microSD card using my 
Windows PC. Why does it show up as having just a few 
megabytes of space left? 

Don’t worry: this is due to the way Windows ignores the 
partitions on the SD card occupied by Linux. However, 
note that as with any installation of Raspbian, you’ll need 

WIFI WOES 

Vm having trouble getting my Raspberry Pi to 
connect to my wireless router using a USB WiFi 
dongle. Any suggestions? 

Mark Jones 


What kind of cable do I need to use the A/V output of 
my Raspberry Pi 2? I want to connect it to an old TV with 
no HDMI port. 

The 3.5mm A/V jack on the Pi 2 and B+ is used to output 
composite video and stereo audio. However, you need 
the right sort of cable for it to work - many of them 
look alike, but aren’t wired in the same way. A Microsoft 
Zune cable will work perfectly. Alternatively, a standard 
camcorder cable should be okay, so long as you switch 
the yellow (video) and red (right audio) RCA plugs. Or use 
an iPod cable and switch the white and red (left and right 
audio) plugs. To force your Pi to use this output 
rather than HDMI, hold SHIFT+3 at bootup for PAL 
video (or SHIFTm for NTSC). 


THE MAGPI APR 

Having trouble with The MagPi on the App Store 
or Google Play? Here are your most common 
questions answered: 

How do I find The MagPi on Google Play 
or the App Store? 

All you have to do is go to the search bar and 
type ‘The MagPi’ or ‘Raspberry Pi’ to find us. 



AJILA2JNC?I 


— 






You didn^t say wbicb dongle you^re using, but try 
tbe following steps... 

1. Enter Isusb in a terminal and you should see your 
WiFi dongle in the output. If not, try using a powered 
USB hub or plug the dongle into another computer to 
check it’s working. 

2. Run Ismod in the terminal to check the dongle’s 
module is loaded. If so, the drivers should be 
loaded correctly. 

3. Next, run ifconfig -a to check 
the dongle is being picked up. 

You should see a Wlano’ in the 
output. If not, you may need to 
install a firmware package for 
your dongle, using apt-get. 

4. If you still can’t get online, 
you’ll need to check the WiFi 
configuration in /etc/network/ 
interfaces (Raspbian). See 
bit.ly/iKtYbqQ for more details. 



I've subscribed to the digital edition and I can't sign in to restore my 
purchases. Please help! 

Since your The MagPi purchases are linked to your Google or Apple 
accounts, there’s no need to sign in at all. If you’d like to re-download your 
purchases on your current device, or make your purchases available on 
other devices, all you need to do is hit ‘Subscribe’ on the home screen, 
then ‘Restore Purchases’ on the next screen. 

How can I search the digital magazine for keywords? 

Finding direct references is really easy with The MagPi app - all you have to 
do is tap the screen to get the app’s GUI to show, and then press the small 
magnifying glass icon in the top-right comer of the screen. Now, just type in 
your search term to find the relevant results. 
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KITRONIK ELECTRO FASHION 


cpc.farnell.com 


£15 / $35 



Related 


ADAFRUIT 

BEGINNER 

L.E.D. 

SEWING KIT 

Coming 
complete with 
needles and 
press-stud 
'switches,' the 
Adafruit kit is 
another great 
way to get 
started with 
conductive 
thread projects, 
but, for the 
money, the 
Kitronik kit 
is likely a 
better buy. 




ELECTRO FASHION 


DELUXE E-TEXTILES PACK 


Promising an entry into the world of wearable electronics for 
under £15, does Kitronik’s kit deliver? Gareth Halfacree sees... 


O or years, wearable 

electronics were either 
bulky and fragile or bulky 
and expensive. Sure, creating 
something like a digital watch was 
straightforward, but the minute you 
wanted your circuits to be flexible, 
things got complicated. Today, 
there are several options for those 
looking to make flexible circuits, 
with conductive thread being the 
most accessible to the hobbyist. 

Designed as an introduction 
to what Kitronik describes as 
^e-textiles\ the Electro Fashion 
Deluxe pack brings together a 
selection of components from the 
firm’s wearable electronics range. 
Inside the blister pack is a trio of 
battery holders - one full-size with 
built-in power switch, one full-size 
without switch, and one micro- 
size for smaller projects - with 


matching batteries. Also contained 
in the pack are pairs of sewable 
LEDs in three different colours, 
pairs of full-size LEDs with built- 
in flashing circuit (also in three 
different colours), a slide switch, 
a momentary push switch, and six 
metres of conductive thread. 

The thread, the real gem of the 
kit, is impressive stuff. Built from 
a traditional thread coated in a thin 
layer of silver, it’s both flexible 
and conductive. Roughly 18 denier, 
it’s somewhat bulky - thicker than 
standard sewing thread, but not as 
thick as that used in upholstery and 
heavy-duty applications - and has 
a somewhat annoying tendency to 
come untwisted at the cut end. 

While the kit comes with most 
of the components you’ll need to 
begin your first project, there’s 
something missing: a needle. 


You’ll need a fairly large-eyed 
needle in order to making threading 
possible, and we’d recommend 
folding the thread in half or using a 
needle-threader: unlike traditional 
cotton thread, the silver-plated 
conductive thread doesn’t stick 
together to form an easily threaded 
point, even when wetted. 

Compared to rival kits, the lack 
of needle aside, Kitronik’ s kit is 
well thought out and comes with 
a reasonable selection of parts. 

The sewable LEDs are a particular 
delight, formed of surface-mount 
LEDs in white, blue, and ^sakura’, 
a lilac-like colour, attached to tiny 
circuit boards with wide ^eyelets’ 
suitable for passing the thread 
through. Sadly, however, they’re 
not labelled beyond markings for 
positive and negative terminals 
and the Electro Fashion logo on the 
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A great 
]y to get 
ittle more 
involved with 
lextiles 

onik 


The lack of needle 
aside, Kitronik's kit 
is well thought out 


rear, meaning you'll have to 
juggle some thread or wire, a 
battery, and the LEDs to find out 
which colour is which. 

The tiny surface-mount 
components continue with a pair of 
switches, one of which has a small 
slide and the other a momentary- 
connection push-button. Like the 
LEDs, these have been designed 
with fabric mounting in mind and 
are extremely compact - definitely 
something to keep out of reach 
of smaller children, owing to the 
potential hazard if ingested. 

The larger LEDs seem out of place 
at first, but a glance at the bundled 
documentation - a full-colour 
booklet walking the reader through 
the basics of sewing a circuit - 
reveals a hidden feature: integrated 
into their bodies is a flasher unit 
which cycles the blue, green, or 


white LED on and 
off every couple of 
seconds. While they lack 
the dedicated sewing eyelets of the 
surface-mount LEDs in the pack, 
it's the work of moments to bend 
the legs into the right shape for 
fabric mounting. 

With a needle threaded and a 
piece of non-conductive fabric 
as a base - we chose a glove for 
our experimentation, equipping 
it with one of the white LEDs on 
the tip of a finger - you can start 
sewing. For beginners to the craft, 
a thimble or two is a must if you 
want to keep your fingertips free 
from punctures; for those who have 
a some sewing experience, adding 
the components is little harder 
than sewing a button to a shirt. 

The thread is flexible, but it is 
not elastic; sew it too tight into 


the bend of a glove's finger, for 
instance, and you can expect to lose 
some freedom of movement or hear 
the disheartening ^ping' of snapped 
thread or a lost component. For 
most uses, though, it should work 
just fine, and with lengths of up to 
45 metres available, the supply of 
conductive thread can be quickly 
and affordably replenished when 
the bundled six-metre allowance 
runs out. 


I^word 

While there aren’t enough components to build 
anything truly exciting, this starter kit offers a 
great taste of what’s possible. Be prepared for 
some frustrations, though, and make sure you 
have a large-eyed needle to get started. 

★ ★★★★ 
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PIANO HAT 


pimoroni.com 

£15 / $24 


^fciKer 

Sag» 

A Pi- 

based piano, 
transformed 
with 

Pimoroni's 

signature 

polish 

Pimoroni 



PIANO HAT 


Les Pounder looks at a HAT-based piano keyboard 
which uses capacitive touch keys for input 


n 2014, a 14-year-old 
called Zachary Igielman 
launched a successful 
crowdfunding campaign for his 
Pi Piano. Originally created using 
a MCP23017 GPIO expander and 
a series of momentary switches, 
the Pi Piano used a piezo buzzer 




MAKEY 

MAKEY 


to simulate the tone of a note. 
One of Zachary’s advisors was 
Phil Howard from Pimoroni, who 
worked with Zachary to create 
this new and improved version. 



This versatile 
board has been 
used to build 
a piano from 
stairs, a camera 
trigger using 
water, and a 


keyboard from 



Crowdfunded project 

The latest incarnation is now 
known as Piano HAT and uses a 
capacitive touch-based interface 
to simulate a portion of a 
traditional piano keyboard. The 
board measures 64mm by 56mm 
and fits neatly on top of the 
models A+, B+, and Pi 2. Being a 
HAT board, it also attaches to all 
40 of the GPIO pins. As well as 
the keyboard, we have the ability 
to raise and lower the octaves 


and change instruments via three 
extra inputs on the board. 

Hardware is just one part of this 
project, and the software which 
supports Piano HAT is all based 
on Python, which enables existing 
projects created in this language 
to easily integrate Piano HAT. Phil 
Howard has written a series of 
examples which use the Pygame 
library to demonstrate how to use 
Piano HAT as a typical piano via a 
series of audio samples, which can 
be swapped for any types of sounds 
should you wish to build your own 
input. Piano HAT also comes with a 
tutorial which demonstrates using 
the built-in LEDs to teach playing a 
simple tune, in this case ^Twinkle, 
twinkle, little star’. So, using 
this library, we can code our own 
tutorial for others to learn with. 

Powerful MIDI 
synthesiser 

Software is not just limited to 
simple samples. In fact, Phil has 


supplied a number of methods to 
connect the Piano HAT library to 
a MIDI service running on your 
Pi. This then turns the Piano HAT 
into a powerful synthesiser input 
for software such as Yoshimi and 
SunVox, although a Raspberry Pi 2 
is required for these applications. 

The Piano HAT looks like a 
rather simple board, but thanks 
to a clear Python library, well-built 
hardware, and a powerful MIDI 
control option, we have a board 
for musical adventures. 


I^word 

Such a simple board, but with 
Limitless applications thanks 
to Python and MiDi. This is a 
great platform for musical 
experimentation and it can 
easily be used with Minecraft 
and other projects. 

★★★★★ 
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IQAUDIO PI-DAC+ 


1 

lqaudio.com 

■ 

1 

1 

£30 / $50 

1 


‘Maher 

Sag» 

\ Outstanding 
sonic performance 
with variable 
phono line out 
and dedicated 
headphone 
ampiifier 

IQaudIO 


IQAUDIO PI-DAC+ 




‘Related 


AUDIOPHONICS 
l-SABRE 
DAC ESg023 


The DAC from 
Audiophonics is 
a similar price 
to the Pi-DAC+, 
but it Lacks a 
headphone 
output. It uses 
the Sabre 
ES9023 DAC 
instead of 
the Texas 
Instruments/ 
Burr Brown DAC 
in the Pi-DAC+, 
and includes a 
pass-through 
GPIO connector 
so you can 
stack additional 
boards. 



Any Raspberry Pi becomes an audiophile music streamer 
with this high-resolution DAC and headphone amplifier 


ven a standalone Pi makes 
a very decent music 
streamer, but add a high- 
quality DAC and it becomes a true 
audiophile device. The IQaudIO 
Pi-DAC plus is a HAT-compliant 
board which uses the PS interface 
for optimal transmission of digital 
audio between the Pi and the DAC. 
Once fitted, you get analogue output 
from either two phono sockets, 
for connection to an amplifier, or 
a 3.5mm headphone socket, along 
with additional pinouts for adding 
optional features. 

No soldering required 

The board comes without any 
instructions, but you can find 
these on the IQaudIO website. No 
soldering is required, and it works 
with Raspberry Pi A+, B+, and 2. You 
need to screw the supplied spacers 
to the Pi to support the board, then 
you simply connect it to the Pi’s 
GPIO board, screw it down gently, 
and that's that. 


IQaudIO can also supply a case, 
an acrylic affair that has suitable 
cut-outs for the Pi-DAC+ ports. 

Once assembled, you can 
download a number of audio-centric 
distributions that have Pi-DAC+ 
drivers built in - including Volumio, 
RuneAudi, and PiCorePlayer - or 
follow the directions to add support 
to an existing installation. There 
is also a preconfigured Raspbian 
image on the IQaudIO site. We 
used Volumio 1.55, which worked 
perfectly. The music source can be 
anything from files on a NAS, to a 
streaming service such as Spotify, 
or a directly attached USB hard drive. 

ExcGliGnt sound 

The DAC sounds excellent, 
powered by a Texas Instruments 
PCM5122 DAC at resolutions up 
to 24-bit/i92kHz. From a sonic 
point of view, a Pi equipped with 
a DAC like this can hold its own 
with far more exotic and expensive 
company. We were also impressed 


with the headphone output: 
tested with a pair of Sennheiser 
HD600 headphones, the sound 
was superb, with the clarity 
and spaciousness that you get 
from the best audio. 

Expansion options at extra cost 
include attaching a rotary volume 
control or an IR sensor for remote 
volume control. The Pi-AMP+ is 
2X20W stereo amplifier which 
attaches to the top of the board. You 
can also use the supplied optional 
right-angled header, designed to be 
soldered underneath the Pi-DAC+ 
to access the Pi’s GPIO signals. 


Inward 

Great sound and the inclusion 
of a headphone amplifier make 
the Pi-DAC+ a recommended 
accessory for music-loving 
Pi enthusiasts. 

★★★★★ 
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LIGHTBERRY 



lightberry.eu 



From £52 / $81 

^itaker 

Sayi 

H^uplrnenu suchm poww i 

Easy 
to install, 

. ■ Filme 

“ P’- V;: f/"' 

simple to 
use, a joy 
to watch 

Lightberry 


1 


LIGHTBERRY 


‘Related 


PHILIPS 

AMBILIGHT 

The real 
alternative 
to Lightberry 
is an actual 
AmbilightTV. 
The cheapest 
we could find 
(at the time of 
writing) was 
£350. Ouch. 


^ ' 

1 ^ 

From 
£350 / $550 

bitly/UiGmgY 


Russell Barnes tests a technology designed to add a new dimension 
to your home cinema experience 


O ightberry is inspired 
by a TV technology 
pioneered by Philips 
called Ambilight. While the tech 
naturally comes pre-fitted on 
Ambilight TVs, it’s perfectly 
possible to modify any TV to add 
its special kind of ambience- 
enhancing trickery. What does it 
do? The premise is simple: you 
affix a ring of colour-switching 
LED lights to the back of your 
LCD TV and - assuming your TV 
is against a wall and the ambient 
lighting is low - the colours on 
the LEDs are designed to perfectly 
sync with the action on screen 
in colour and intensity, so that 
light appears to bleed out of the 
screen and dance against the wall 
in the background. 

As with Philips’ creation, 
Lightberry - which harnesses 
the power of the Raspberry Pi for 
computation - is all about adding 
a little more immersion into your 
viewing experience. While the idea 
is simple, the technology behind 


it certainly isn’t, though for most 
people the results really do speak 
for themselves. 

Sold either as a full kit starting 
from just over £50 / $80, or 
as constituent parts available 
separately, Lightberry is 
designed to take the pain out 
of the technical aspects, giving 
you as close to a plug-and-play 
experience as you could hope for. 
Obviously, sampling millions 
of pixels of onscreen data and 
converting that to the right LED, 
colour and brightness at exactly 
the right moment isn’t the 
simplest project to tackle, but 
Lightberry manages to make it 
easy. It’s also designed to work 
perfectly with the best software 
solutions for this technology, too, 
including Hyperion and Boblight. 

Once you’ve picked the right 
length LED strip to fit your 
particular size of TV and ordered all 
the kit you need, it all arrives boxed 
and ready to assemble. While we 
found no instructions in our box. 


lightberry . eu/getting- started 

offers brief but functional step- 
by-step instructions to get you 
up and running. Probably the 
fiddliest part of the process 
is arranging and affixing the 
LEDs themselves. Elsewhere it 
simply requires you to connect 
the appropriate converter box, 
download software and install it 
onto an SD card - a process any 
Raspberry Pi user should already 
be intimately aware of. 


I^word 

While it can take a Little trial 
and error to best position 
the LEDs, once you’ve hit 
the sweet spot we found 
Lightberry a joy to use. it’s 
not the cheapest Raspberry 
Pi project, but it’s one that is 
sure to please the movie fans 
in your household. 

★ ★★★★ 
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WINDOWS 10 lOTCORE 


dev.windows.com/en-us/iot 



Sayi 

Rapidly 
prototype 
and build 
your Windows 
loT solutions 

Microsoft 


WINDOWS 10 lOT CORE 


What are we to make of Microsoft’s first foray onto the Raspberry Pi? 

Lucy Hattersley investigates... 


Related 


SNAPPY 

UBUNTU 

CORE 


Snappy 
Ubuntu Core 
is a stripped- 
down version 
of Ubuntu 
aimed at loT 
development. 

It utilises a new 
'Snappy' means 
of updating 
packages. 


« 



O t’s all too easy to get hung 
up on what Windows loT 
Core isnh. It certainly 
isnh Windows desktop on your 
Raspberry Pi, or even a cut-down 
version such as Windows RT. There 
is no Start button here. 

Windows loT Core is also not 
a self-contained programming 
and development environment. 
There isnh a shell in the OS, so you 
canh type commands directly into 
your Raspberry Pi. In fact, there’s 
no interface at all: plug it into a 
monitor and it simply displays 
the IP address and a few other bits 
of information. 

Beyond that, there’s the moral 
maze of Windows not being 
open-source, unlike Linux (which 
underpins Raspbian, Ubuntu, and 
most other Raspberry Pi OSes). As 
Linus Torvalds, principal developer 
of Linux, points out, open source 
isn’t simply an ethical way to create 
software - it’s a more efficient way 
to create better software. Open 
source enables users to pool efforts 
and build upon the work of each 
other. It’s also more fun. 


Welcoming Windows 

Reaching beyond all those issues 
brings you to the good. Windows 
loT Core is close in essence to 
Windows Embedded (or Windows 
CE). That’s the software that sits 
behind information kiosks, photo 
booths, and countless advertising 
displays. loT Core is ubiquitous in 
nature, too, which makes it worth 
investigating for its own sake. 

Windows loT Core offers real 
value for OEM developers to use 
Raspberry Pi devices for testing. 
Those people looking to learn 
Microsoft development will 
find the Raspberry Pi a great 
learning platform. 

Installation and 
development 

Eor the rest of us, Windows loT 
Core is an odd beast. Setup is 
straightforward but long-winded. 
You will need a PC running 
Windows lo, and you need to 
have installed Microsoft Visual 
Studio (the Community version is 
free). You need to put Windows lo 
into Developer mode and use the 


software to flash your SD card. 
Place this into the Raspberry Pi, 
boot up, and you’ll see a welcome 
interface displaying the currently 
used IP address. You use this 
to connect from the Windows 
PowerShell and Visual Studio. All 
development takes place inside 
Microsoft Visual Studio. 

Microsoft has integrated GPIO 
support, and sample code is 
available in C# and C++. Microsoft 
has already provided a great 
selection of online tutorials, and 
we counted over 6o projects to help 
you get started. 


I^word 

Equipment developers will find 
the Raspberry Pi a great low- 
cost development platform, 
if you want to be inside the 
Microsoft ecosystem, or just 
want to learn C# and Visual 
Studio, then this is a great 
way to start. 

★★★★★ 
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SONIC PI V2.6 


flloKer 

Sagi 

A free 
live coding 
synth for 
everyone 

Sonic Pi 



with_fx : reverb do 
use_synth ; blade 
play 54, sustain: 5 
sleep 0.5 

play 56, sustain: 4.5 
sleep 0.5 

play 60, sustain: 4 
end 


SONIC PI V2.6 


Les Pounder finds out how you can create music using your Raspberry Pi 
via an easy-to-learn language and great new interface 


‘Related 


PIANO HAT 

An elegant 
musical 

interface for the 
Raspberry Pi. 
Using Python 
and MIDI 
interfaces, it 
enables coders 
to hack tunes in 
many different 
ways. 



O n 2012 we saw the release 
of the original Raspberry 
Pi, but behind the scenes 
in Cambridge, Sonic Pi was in the 
early stages of prototype. In fact, 
the first version was compiled using 
the original Raspberry Pi by Dr Sam 
Aaron, in consultation with the 
Raspberry Pi Foundation’s future 
employee Carrie Anne Philbin. 

The original use-case for Sonic Pi 
was for a series of eight lessons 
in Carrie Anne’s IT classes, where 
Sonic Pi would be used to teach 
computer science and music in a 
new and exciting way. Fast-forward 
to today and we find that with each 
new version. Sonic Pi has grown 
in features, with refinements and 
additions that excite and intrigue 
budding musicians and coders. 

But does it still meet its goal? 

Algorave 

With the latest version 2.6, 
code-named Algorave, the first 
thing that we notice is that the 
version 2 user interface has been 


improved. The new interface has 
a flatter look and uses the Sonic 
Pi branding, along with a hot pink 
colour for highlighting workspaces. 
Workspaces are now renamed 
^buffers’ to accommodate users with 
low-resolution displays and their 
limited screen real estate. The user 
interface retains its familiar layout, 
with buttons for quick access located 


palette, suitable for live coding 
performances, something which 
Sonic Pi 2.6 has been geared towards. 
Further user interface configurations 
include options to show/hide aspects 
of the GUI, such as the buttons at the 
top of the screen. 

Musically, Sonic Pi 2.6 comes with 
more synths, instruments which 
change the sound of notes; we are 


a 


We have seen it come of age 
thanks to a mature language 
and slick interface 


to the top of the screen, a coding 
window to the left, a log/preferences 
section to the right, and the 
excellent help system at the bottom. 
Along with the new user interface, 
we also find a new Mark mode’ 
in the preferences section. This 
mode changes the familiar white 
interface to a dark and mysterious 


particularly fond of Mlade’, which 
has a sound reminiscent of Blade 
Runner’s synth violins. There are 
also more effects that can be applied 
to instruments, such as panslicer 
which modulates the stereo panning 
of audio for some rather trippy 
results. Effects can be used to 
change a sound or instrument for 


82 


September 2015 


raspberrypi.org/magpi 















SONIC PI V2.6 


Heview 


SI 



Qs - *© ^ B (pi@Fa£pbenVpp: ■ 


= 4 I »>!’3.-28| 


2 Iive_loop do 

2 Lise_bpiii 120 

3 Lise_syn’th ■ 

4 pl.ay_patt©rn [ . 

5 &nd 

6 

7 l.iv€_loop - do 

S use_bpm 120 

9 U3e_3yrTth : 

10 play_pattern [70,72,74] 
J2 end 


Show log 
show biJttons 
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Show liw fiumbera 


SlucliO Update 


Buffer 1 Buffet 2 Buffer s Buffet 4 Buffet 5 Buffet 6 Buffet 7 Buffers Buffer 9 


Cue :test 

4 ..: 


1 Welcome to Sontc Pi 
T.1 Uve Coding 

1 2 Exploring (he Interface 

13 Learning through Play 
2 Svnih£ 

2 1 Vouf First Beeps 
“ Examples Synths . » 


Welcome friend ;-) 


Welcome ta Sonic Pk HopofLilly 'fou'n ac OKcitod to got ctortfrd making craz.y sounds as i am Co show you It's going to bs a realty .i/nride 
where you'll loam all about muaic. eynthatea. programming, composition performance and mote. 

But wait how rude of mel Let me introduce mysalf ■ Tm Sam Aaron ■ the chap that ctealed Sonic PL You can find me at (gisamoaron on 
T witter and I'd be more than happy to say hallo to you. You might also be Intatasted in my Ltve Coding band Meta-eX where I perform with 
rwfe in fiont of You cat n find rme of mv Meta -a X Cn!ic:l(s in the ejtnmnlofi 


varied results; for example, reverb 
is often used to give an instrument 
a sense of acoustic space. 

Sonic Pi has a built-in help 
system which equates to a full 
manual on how to use it. It’s a 
great read that is constantly being 
updated with each new release, and 
this is the case for v2.6, with all 
of the new functionality, FX, and 
synths being listed with examples 
of their use. 

Improved error handling 

In previous versions of Sonic Pi, 
the error and syntax handling 
when encountering an issue 
has left some new users a 
little bamboozled. In Sonic 
Pi 2.6, however, we see the 
introduction of a new error 
message reporting system. This 
pinpoints the issues via an arrow 
in the left margin, along with an 
improved description of the error 
encountered in the output window, 
with syntax errors highlighted in 
blue and runtime errors in pink. 


These improvements provide an 
enjoyable and friendly experience 
when composing your first track. 

Sonic Pi also boasts an 
impressive interface to Minecraft, 
which was introduced in V2.5 and 
originated during a conversation 
between Sam Aaron and Martin 
O’Hanlon. Now, using Sonic Pi, you 
can create music and alter a world 
in Minecraft to interact with the 
music, a truly epic experience for 
children and adults alike. In Sonic 
Pi 2.6 we see a bug fix for the 
mc_surface_teIeport function, 
along with a few other logic fixes. 

With the release of Sonic Pi 2.6, 
we can see it come of age thanks 
to a mature language and slick 
interface, and it has become clear 
that it is one of the key projects 
for the Raspberry Pi. It merges 
computer science, thanks to a 
solid base in the Ruby language, 
with music theory for impressive 
results in a short amount of time. 
Using Sonic Pi in live performances 
is now accessible to anyone, with 


yLtrJ-tHm £ 


refinements to the language and 
functions to handle complex tasks. 

Coding as an art form has finally 
become reality, and that is all 
thanks to Sonic Pi. 


I^word 


Sonic Pi is sure-fire hit, 
adding yet another string 
to the bow of the Raspberry 
Pi. Merging music with code 
enables anyone to compose 
great-sounding audio using 
a simple language. 


Above Error 
handling, along 
with user direction, 
has improved 
and now makes 
debugging a 
simple process 

Top Live coding 
is at the heart 
of Sonic Pi, and 
the new dark 
mode creates a 
moody palette 
for performances 


★ ★★★★ 
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Heview 


BOOKS 


RASPBERRY PI 

BESTSELLERS 


APRESS 


Apress has several practical backs far Pi 
users. Here's aur pick from the most popuiar 


LEARN RASPBERRY PI 
PROGRAMMING 
WITH PYTHON 


Author: Wolfram Donat 
Publisher: Apress 
Price: £i7-50 
ISBN: 978-1430264248 
bitly/iLeMgNS 

Project-based Python intro 
for the Pi: make a web spider, 
a weather station, a media 
server, a home security system, 
an underwater photography 
system, and a near-space 
weather balloon with a camera. 


Daspberry P' 

python 


RASPBERRY 
PI HARDWARE 
REFERENCE 

Authors: Warren Gay 
Publisher: Apress 
Price: £11.50 
ISBN: 978-1484208007 
bitly/iKWUipn 


Delve deep into the Pi's 
workings for your sensor 
project: power, memory, USB, 
Ethernet, SD cards, I^C, GPIO, 
and the UART (serial) interface. 
With test code in C. 



BEGINNING SENSOR NETWORKS 
WITH AROUINO ANO 
RASPBERRY PI 


Authors: Charles Bell 
Publisher: Apress 
Price: £23.50 
ISBN: 978-1430258247 

bitly/iuuiHaB 


Build a Raspberry Pi-based 
sensor node, then connect 
Arduino sensor nodes and 
XBee radio modules to the Pi, 
and collect data on a Pi-hosted 
MySQL database server. 



RASPBERRY PI 
FOR KIDS 

Author: Richard Wentk 
Publisher: Wiley 
Price: £21.99 
ISBN: 978-111904951-7 
bit.ly/iK7C4iE 


A well-paced 
introduction that 
goes from setting up 
to programming and debugging, 
embracing command line skills 
along the way. Fun software 
projects - like Turtles and Minecraft 
(controlling both with Python), 
simple and dynamic websites, 
and using a webcam - introduce 
many useful computing skills. 
Remembering the intended target 
audience, the inevitable setting- 
up chapters are both necessary 
and well judged, with details on 
cables and other information to 
enable younger makers to get going 
without adult help. 


Ignoring the ^For Kids’ branding, 
this book would be a valuable start 
for any nervous adult computer user 
keen to gain Pi enlightenment. 
From command line and 
nano, to Python, choosing 
a web server and learning 
programming skills, Wentk 
introduces and teaches using 
Raspbian. He does so in a clear 
style with gentle humour and 
an ability to make each learning 
challenge approachable. 

PHP may be losing its lustre but it 
gives the quickest start in working 
with data, and is subsequently 
used for running shell and Python 
commands. Running webcam. py 
within PHP then leads on to 
debugging web problems, fixing 
Unix file permissions, and testing 
your software - all essential skills 
for growing your knowledge after 
finishing the book. 


Score ★★★★★ 


W 



FUNCTIONAL 
PROGRAMMING 
IN PYTHON 

Author: David Mertz 
Publisher: O'Reilly 
Price: Free PDF download 
oreiLly/iKclhgo 


Functional programming 
^ Worries about what is to 
be computed rather than how 
it is to be computed,” preferring 
the evaluation of expressions over 
statements, and treating functions 
as first-class objects (you can pass 
a function to another function as 
if it were a piece of data). Python, 
despite not being a functional 
programming language, is ^^a 
multiparadigm language that makes 
functional programming easy to do 
when desired, and easy to mix with 
other programming styles.” 

Right from the first chapter, 
^(Avoiding) Flow Control’, the 
author (a Python Software 


Foundation director and sometime 
philosopher) brings you code that 
is subtly altered from imperative 
samples, with changes that 
won’t alarm you but 
will work softly on your 
brain, cumulatively 
helping to shift focus 
from the ^how’ to the 
'what’. 

"Simply changing the 
form of expression can 
often make a surprisingly 
large difference in how 
we reason about code and how easy 
it is to understand,” says Mertz, 
as he uses list comprehensions, 
generators, and dictionaries and 
sets to abstract the 'how’ and 
reorder our thinking on data, 
working up to lazy evaluation and 
higher-order functions (those that 
call or generate other functions). 

A good, quick introduction for all 
Pythonistas looking beyond OOP. 


Score 


W 


l^uncocnal 
pogrammine 
'n Python 
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BOOKS 


Heview 


THE 

HARDWARE 
STARTUP, 


Author: Renee DiResta, Brady 
Forrest & Ryan Vinyard 
Publisher: O'ReiLLy 
Price: £23.50 
ISBN: 978-1449371036 
oreiLly/iLRSDmb 


THE 

STARTUP 


The hardware startup 
company of today is 
a very different beast from its 
antecedents, thanks to the very low 
cost of prototyping with boards like 
the Pi and Arduino, a new ecosystem 
for hardware manufacturing, 
including small manufacturing 
runs and 3D-printed parts, and the 
transfer of lean techniques from 
software to hardware businesses. 

In The Hardware Startup, DiResta, 
Forrest and Vinyard provide a 
roadmap for anyone enticed by the 
lower cost of entry to transform 
their side project into a hardware 




business. From prototyping and 
manufacturing, to community 
engagement and legal concerns, 
and every aspect of developing 
and producing a product then 
I getting it to customers, is 
' considered in appropriate 
depth for those thinking 
seriously of turning 
a product idea into 
a business. 

Open-source hardware 
is only touched on briefly, 
and selling your users’ data 
is almost taken for granted, 
but the focus on a narrow, 
Silicon Valley view of what a startup 
is all about is unsurprising, given the 
smaller number of community and 
cooperative ventures in hardware 
than in software. However, the 
Raspberry Pi itself stands as 
a shining example of a social 
enterprise approach to running 
a successful hardware business. 


Score ififififif 



RASPBERRY PI 

COMPUTER VISION 
PROGRAMMING 

Author: Ashwin Pajankar 
Publisher: Packt 
Price: £16.99 
ISBN: 978-1784398286 
bit.ly/iPdzlbf 

Learning 
computer vision 
is best tackled with a practical 
approach: using the BSD-licensed 
OpenCV library, which enables 
image and video processing in 
C/C++, Java, and Python. Pajankar 
introduces OpenCV in a specific 
Pi/Python context but assumes no 
previous Raspberry Pi knowledge 
- fortunately, his Pi introduction 
is admirably brief. However, the 
OpenCV installation section is 
strangely lacking in refinement. 

Python knowledge is assumed, but 
only the basics: NumPy is introduced 
early, for the mathematical 


functions needed in using OpenCV. 
Practical examples on images 
and webcam, using the Pi Camera 
Module, carry the less mathematical 
reader through. Noise removal 
and edge detection, useful tasks 
for your own Pi camera projects, 
are followed by motion detection 
and barcode reading. More real- 
life computer vision techniques 
are covered; there is a longer 
nal chapter on the SimpleCV 
Drary, a framework to make 
computer vision tasks easier. 
While many OpenCV books are 
now available, others focus on C++, 
Java, and cross-platform Python 
programming. We could be picky 
about the coding style but overall, 
for a Pi user with a little Python 
experience looking to get started 
with OpenCV and learn the basics of 
computer vision, this curate’s egg of 
a book has much to teach. 


Score ★★★★★ 


ESSENTIAL READING: 

APPLIED PYTHON 


Not just fortooching & Pi projects, Python’s o 
great language for real-world tasks of oil sorts 


Python Data 
Science Essentials 

Author: Alberto Boschetti 
& Luca Massaron 
Publisher: Packt 
Price: £26.99 
ISBN: 978-1785280429 
bit.ly/ibCAZEA 

Direct and practical introduction to data 
analysis with Python, with good code 
examples and a problem-solving focus. 



Web Scraping with Python 

Author: Ryan Mitchell 
Publisher: O'Reilly 
Price: £21.50 
ISBN: 978-1491910290 
oreiLly/iNkXYBu 

Thorough grounding in the basics of web 
scraping, with balanced and concise 
coverage of a topic that continues to grow. 



Mastering Python 


for Finance 


Author: James Ma Weiming 


Publisher: Packt 


Price: £32.99 


ISBN: 978-1784394516 


bit.ly/if32g4U 


Comprehensive collection of financial theory and ^ 


mathematical models applied to lucrative problems, 
with OOP and FP. Educational and interesting. 


Black Hat Python 

Author: Justin Seitz 

Publisher: No Starch 

Price: £23.50 

ISBN: 978-1593275907 

nostarch.com/blackhatpython 

Penetration testing and security analysis, 
writing network sniffers, manipulating 
packets, infecting virtual machines, 
and creating stealthy Trojans in Python. 


Hack Hat Python 



Learning Robotics 
Using Python 

Author: Lentin Joseph 
Publisher: Packt 
Price: £29.99 
ISBN: 978-1783287536 
bitly/iIrlaeZ 

"Robotics is an art." Python, ROS, 
and OpenCV, for building interactive 
autonomous mobile robots from scratch. 
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WANT TO GET 

NOTICED? 


REACH THE RIGHT 
AUDIENCE FAST 

> World’s #1 Pi magazine 

> Block booking discounts 

> Free to download & share 

> Live links on iOS & Android 

The MagPI is the most exciting mag in tech today, boasting 
one of the biggest &l mcst engaged audiences in the Industry. 


ADVERTISE IN THE MAGPI MAGAZINE 



Easy to INSTALL 
A joy to WATCH 

Mode for 


The Prototyping Board 

makes it easy to create original Raspberry Pi projects 



Provides easy access to all GPIO pins 

Adds functionality to your Pi, such as: 

> analog inputs 

> LEDs and pushbuttons 

> USB serial console port 

Includes a set of projects to get you started. 





Educational discounts available 


lightberry.eu rQspberry-ot-home.com 


www.gooligum.com 








INTRODUCING 




DESIGNED SPECIFICALLY FOR THE RASPBERRY PI 2 MODEL B 


FEATURES INCLUDE: 


• 5v 3A power supply 

• 5 external and 1 internal USB ports 

• Power switch 

• IR receiver & media remote 


This case is a perfect accompaniment to 
the amazing Raspberry Pi 2 Model B, 
supporting and extending it for those users 
who want a consumer friendly case for their 
favourite ARM-powered computer. Be the 
first to own one of this limited run! 




WWW 


.sbc- 


I.CO 


.uk 


Call: 0203 514 0914 


At SB Components we strive to offer our customers ttie best prices for the best products. 

Our product team works tirelessly to source top quolity nffordoble components from around the world. 

■ m PflspbePTy Pi is n IrarftimartL of jlie RinpbeTiy fi founddioi. RflspfaeTiy Pi not ncbikd. witfi Rtepberiy Pi 







Communitu events 


^g fAiaas^aig »g« 

EVENTXALl 

Find out what communit]^Drganised, Rasp 
events are happening nearlou... 


emed 


^ 1528 Connecticut Ave NW, WashingJ^Bc, US 


RASPBERRY JAM SILICON VALLEY 


Computer History Museum, Mountain View, USA | 


PUT YOUR EVENT ON THE MAP 

Want to add your get-together? List it here: 

raspberrypi.org/jam/add 



PRESTON RASPBERRY JAM 

When: Monday 7 September 
Where: Media Innovation Studio, 
Media Factory Building, 
Preston, UK 
bit.ly/iKvamMh 
Join in for a day of fun lightning 
talks, demonstrations, and 
hands-on time with the Pi. 



NORTHERN IRELANO 
RASPBERRY JAM 

When: Saturday 12 September 
Where: Farset Labs, Belfast, UK 

bit.ly/iKsihnJ 

A regular gathering for everyone 
from complete beginners to 
advanced enthusiasts. All 
equipment provided. 



COOEROOJO HAM MINI-JAM 

When: Saturday 12 September 
Where: Ham Youth Centre, 

Ham, UK 

coderdojoham.org 

Aimed at 7 to 17-year-olds, varied 
activities include Raspberry Pi 
projects. Python programming, 
and Scratch. 



CAMBRIOGE RASPBERRY JAM 

When: Saturday 12 September 
Where: Institute of Astronomy, 
Cambridge, UK 

camjam.me 

One of the biggest regular Jams 
in the home of Raspberry Pi. 
Excellent facilities for talks, 
demos, and workshops. 



TORBAY TECH JAM 

When: Saturday 12 September 
Where: Paignton Library and 
Information Centre, 
Paignton, UK 
torbaytechjam.org.uk 
Come along for a fun, informal 
day of hacking with your own kit, 
or use the equipment provided. 



RASPBERRY JAM 
SILICON VALLEY 

When: Saturday 19 September 
Where: Computer History Museum, 
Mountain View, USA 

bit.ly/iIKPPZi 

This regular monthly Jam welcomes 
Pi enthusiasts, educators, students, 
curious onlookers, and anyone else! 
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COTSWOLD RASPBERRY JAM 

When: Saturday 26 September 
Where: University of Gloucestershire, 
Park Campus, 

Cheltenham, UK 

cotswoldjam.org 

A new venue will provide extra space 
for larger tutorial sessions and more 
attendees. Bring along your Pi. 


RASPBERRY PI DC MEETUP 

When: Monday 28 September 
Where: 1528 Connecticut Ave NW, 
Washington DC, USA 

bit.ly/ij3kMTr 

For everyone from masters to 
novices, talks will range from 
the most in-depth projects to 
intro-level concepts. 


DON'T MISS: 

NORTHERN IRELAND 
RASPBERRY JAM 


When: Saturday 12 September Where: Farset Labs, Belfast, UK 


Hosted by PiNet creator Andrew Mulhollond, 
this regular Jam features a wide range of 
fun activities to try out, including getting 
started with Raspberry Pi, electronics, Python, 
hacking Minecraft Pi, exploding balloons, 
and creating an automated parent detector! 
Andrew says, “We always have plenty of 
beginners at each Raspberry Jam, usually 
after parents buy them Raspberry Pis and 










TAKE US ANYWHERE 



rCUR OFFICiU RASPBERRY PI KASAIINE 


with a Newsstand 
subscription 

(limited time offer) 




AMAZING PI 

PROJECTS. 
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Available now 

for smartphones & tablets 


Availible on the 

w AppStore 



fromjuAt 

£2.29 or £19.99 

rolling subscription full yeor subscription 

why buy digitally? 

• Get all copies back to issue 31 

• Instant downloads every month 

• Fast rendering performance 

• Live links & interactivity 


90 


Ma^Pi September 2015 


raspberrypi.org/magpi 






In association with: 

raspberrypi.org 


DIGITAL SUBSCRIPTIONS 

MUST BE WON! 


WHAT IS YOUR 

FAVOURITE 


TABLET 

DEVICE? 

Tell US by 25 September 
for your chance to win! 


How to enter: 

All you have to do is email 
competition@raspberrypi.org 

letting us know what tablet device 
you use, or that you’re considering 
buying in the next six months. 



7D PAGES OP ESSENTIAL RASPBERRY PI KNOWLEDGE G KNOW-HOW 


RasPi 

Model 


CROWDFWimNffS 

greatesthits 


NATURE 

BYTES! 


pau SQNIC PI: MAKE AMAZING MUSI D WITH OUR ESSENTIAL TIPS & TRICKS 


Terms & Conditions 

Competition closes 25 September 2015. Prize is offered worldwide to participants aged 18 or over, except employees of the Raspberry Pi Foundation, the prize supplier, 
their families or friends. Winners will be notified by email after the draw date. By entering the competition, the winner consents to any publicity generated from the 
competition in print and online. Participants agree to receive occasional newsletters from The MagPi magazine (unless otherwise stated upon entry). We don't like 
spam. Participants' details will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and no cash alternative will be offered. 
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Image: Clive Beale 



HOW DO YOU INSPIRE 


™’R8^8STEM? 


The Raspberry Pi Foundation’s Clive Beale tackles 
this month’s big question... 


Below Buttons, 
LEDs, and even 
the Pi camera are 
easily controlled 
in Scratch 


O nce upon a time, someone 
in an education meeting 
got really bored of having 
to say ^science, technology, 
engineering, and maths’ all the 
time. After 20 minutes of serious 
thinking, and many failed ideas 
(METS, TEMS, SMET...), they 
invented the acronym ^STEJVE. 

If you Google ^stem’, you don’t 
get pages about plants but lots 
of serious chatter about how 
important STEM is and why more 
people (especially young people) 
should do it. And it is important 
- it tells us how the world works 
and allows us to change it. STEM 
underpins and informs modern 
life, from cancer cures to Facebook; 
from space exploration to robot 
vacuum cleaners. 

So far, so functional, but it’s 
not the best way to inspire most 
children. Horror tales of the olden 
days when the only social media 
was graffiti in public toilets, and 
your mum issuing you with an 



emergency 2p piece to call home 
just don’t cut it. Fortunately, 
we have a secret weapon. STEM, 
as well as being important, is 
exciting, creative, challenging, 
and fun. So how do you get kids 
into STEM? All you need is some 
inspiration and a Raspberry Pi. 

Hack your hobby 

If you are not interested in 
something, then the bad news is 
that STEM won’t make it more 
fun. Anything that you do enjoy, 
however, can be exponentially 
expanded, extended, and improved 
when you throw a little STEM into 
the mix. It doesn’t matter whether 
that interest is LEGO, music or 
knitting: there’s always a way to 
hack your hobby with a Raspberry 
Pi and inject some STEM into it. 
And if your hobby is already STEM- 
based (astronomy, robotics, cold 
fusion), then a Pi will make it 
bigger, better, and faster. 

start Gorly 

There’s a saying in computing 
education: ^age eight is too late’. 
While the age is arbitrary (based 
as it is on rhyming with Gate’), the 
concept is sound and the sooner 
kids get into STEM the better. 
Realistically, this means starting at 
home. Once children see that they 
can make a computer do things 
there’s no stopping them, and 
the ideal tool to foster this is the 
programming language Scratch. 

That’s the whole of STEM 
covered by a single program and 


accessible to preschool children. 
The physical computing aspect 
is particularly inspiring and a 
powerful way to learn. Which 
brings us to my favourite way 
to inspire kids in STEM... 

Get physical 

School tech departments once 
rang out to the happy sounds 
of children setting fire to their 
shoes with molten aluminium and 
welding the teacher’s chair to the 
ceiling. Sadly, this is now frowned 
upon. But humans are curious and 
creative animals, and physically 
manipulating the world around 
us is compulsively engaging. 

STEM scratches that evolutionary 
itch and the Raspberry Pi makes 
it accessible. 

Physical computing covers 
everything from flashing an LED 
to sending a Pi into near space. 

It’s really cheap to get started and 
you can make surprisingly brilliant 
things for very little outlay. It’s 
also a chance to repurpose things 
you’ve got lying about the house - 
those Wii Remotes in the kitchen 
drawer, or the old remote-control 
car under the bed. Break things and 
then rebuild them better. Break 
things and make something else. If 
you live in a weird minimalist box 
of glass and steel and have no junk, 
then ask your school or relatives. 

Or salvage stuff - just remember 
to ask the owner before you root 
around in their skip. And don a 
titanium exoskeleton for health 
and safety reasons. 
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Join in 

The advice here is simple: get 
involved with the community, as 
it’s a terrific multiplier in terms 
of skills and confidence. Whether 
you need technical advice on a 
project, are looking for someone 
to collaborate with on your latest 
madcap scheme, or are just 
plain flummoxed, then you are 
in luck because the Raspberry Pi 
community is one of the most 
helpful and friendliest around. The 
official forum (raspberrypi.org/ 
forums) has experts in all of the 
STEM fields and any questions are 
usually answered within minutes. 

If you have an idea for a STEM 
project but are not sure where to 
start, then this is the place to ask. 
Someone has probably tried it 
before and would be happy to share 
their experiences. 

Image courtesy of; Dove Akermon and St Alban's School 


Of course, the community 
extends way beyond the forums 
to include Raspberry Jams, 
competitions, and community 
resources such as TJneMagPi 
that you are reading now 
(raspberrypi.org/community). A lot 
has been written about Raspberry 
Jams, but simply they are one of 
the best places for young people 
and families to learn, get involved, 
have a go, and collaborate on all 
things Pi. There’s only one thing 
better than building a giant. 
Raspberry Pi-controlled, evil robot 
zombie and that’s challenging 
other such robots to a duel. With 
death lasers. 

Competitions are a great way 
to get schools involved in STEM 
and we’ve run several in the 
past. We like to give away cool 
things, so keep an eye on the blog 


(raspberrypi.org/blog). There’s 
also the fabulous PA Consulting 
competition which showcases 
STEM in a variety of themes 

(paconsulting.com/events/ 
raspberry-pi-competition) . 


Above Hacking 
Minecraft at 
the Cambridge 
Raspberry Jam 


Go and ploy 

Although there’s no single way to 
inspire children with STEM, there 
is a simple formula and that is to 
just get stuck in. mess around, and 
make things. STEM is an amazing, 
useful and empowering thing, but it 
can be daunting when you first set 
out. The Raspberry Pi is a great way 
to start to explore these subjects in 
creative, fun and exciting ways and 
when you do that. STEM happens by 
stealth. Go and play. When you do, 
things like this happen... 
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Community 


YOUR LEHERS 



Competition Winners 

Back in issue 35, we asked you to you to let 
us know what you hack and make with your 
Raspberry Pi. In return for an emailed response 
to competition@raspberrypi.org, our friends at 
dawnrobotics.co.uk kindly offered to give away 
their top-of-the-range Raspberry Pi robot worth 
£150 to one winner, and four Dagu Mini Driver MKII 
boards worth £14 to the runners-up. 

Here are the 
winners, who will 
all be hearing from 
us soon! 

Star Prize winner: 

Paul Smith 

Runners-up: 

Theo Frieling 
Ivan Smerznak 
Jason P 
Paul Brown 



DAWIVI 


Articie submission 

I have a Raspberry Pi project that Vd like to 
share. Briefly, we built a daughter board that 
plugs into the GPIO pins on the Raspberry Pi. 

The board is designed to charge and discharge 
a battery using a user-defined constant current 
(10 microamps to 10 milliamps) and a user- 
defined voltage range (e.g. 3-4. 2V for Li-ion; 
0-5V possible). The circuit records voltage, time, 
current and temperature into a text file, as the 
cell is cycled. 

This circuit is very useful for people testing 
batteries (and a hundred times cheaper than a 
similar circuit), or hobbyists who want to know 
more about battery performance. 

Would it be possible to submit an article to 
your magazine based on this circuit? If so, how 
would I go about doing that? 

ShanG Beattie 

Thanks for getting in touch with details of 
your excellent project, Shane! We can imagine 
hundreds of applications for your add-on board 
and Pm sure lots of our readers can too. YouM 
be very welcome to submit an article for us to 
include in the magazine - looking forward to 
taking a look! If any other readers have ideas 
for tutorials, features or reviews to go in the 
magazine, all they need to do is email us at 
magpi@raspberrypi.org with their idea and a 
short example of any writing they Ve done in 
the past. Once we Ve had a brief conversation 
about the article (usually via email or VoIP), 
wehl give you a text document that outlines our 
requirements (images, text format and so forth). 
It really is that easy to feature in the magazine! 


Subscription options 

I am a Tunisian engineer who is very interested in 
this magazine. I just want to know that if I subscribe 
to your magazine for one year, will I get each issue 
monthly? Also, do you ship to this part of the world, 
and if so, do you ship directly to my door or just to 
post offices? 

Oussema Hidri 

Subscribing to the magazine is easily the cheapest 
and most convenient way to secure your issue every 
month. Not only can you save up to 25% on the cover 
price, wehl deliver your copy to your door pretty 
much anywhere in the world. We hope that answers 
your questions, Oussema. Just visit bit.ly/MagPiSubs 
or check out pages 26-27 for more details! The 
magazine is available for £12.99 quarterly (by Direct 
Debit in the UK), six- monthly, and yearly. 
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Community 


YOUR LETTERS 


FROM THE FORUM: 

BLAST FROM THE PAST 

The Raspberry Pi Forum is a hotbed of conversation and problem- 
solving for the community - join in via raspberrypi.org/forums 



External storage tutorials 

Although Tve had my Raspberry Pi for several 
months now, Vm still very much a newbie and ha 
greatly appreciated the MagPi articles that are wri 
primarily for beginners. 

One article that I found particularly interesting 
was ‘External Storage, Part I: File systems, partiti 
tables and rsync^ by W H Bell, which appeared 
in issue 29, December 2014. Please consider this 
note as a request for more articles in the ‘External 
Storage^ series. 

Many thanks for your consideration of this reqi 

Gordon Atkins 


Our opinion was very much reflected in the respo 
forum user Gigapouch received in the thread. 

W H Heydt very much expects his Rasperry Pi to 
outlast him, while rpdom says it’s likely a 


® y Raspberry Pi 2 has been running as a 
web server 24 hours a day, seven days a 
week for the past three months or so, and I 
was using a laptop for a month before that. So far, 
it has received 1,000 visits during that time. How 
much longer do you think it will last? 

Gigopouch 


It’s generally Sod’s law that dictates that as soon 
you ask how long something will last, it immedia 
falls over, never to work again. That said, the 
Raspberry Pi is actually one of the most robust and 
long-lasting bits of kit in your house. It’s very liP 
that it will outlast your mobile phone, laptop or 
classic platter-style hard drive. 


Raspberry Pi 10 will be available long before the Pi 2 
gives up the ghost. Taking it much further, Bobstro 
suggests that a well-designed system such as the 
Raspberry Pi should be able to run more or less 
indefinitely, as long as it has power. ^^There is a story 
about a Novell NetWare server (bit.ly/ij3y3xl) that 
ran for years with no downtime. After four years, 
they decided to track it down, only to find that it had 
been sealed up behind a wall and was still running,” 
he said. For us, though, forum user Johnmann 
sums it up nicely: ^^]ust got my 34-year- 
old ZX Spectrum out of the loft and 
it fired up fine.” 


Thanks for getting in touch, Gordon. We’re glad you 
enjoyed Will Bell’s piece from the end of last year. As 
you’ll see from the tutorial on pages 64-67, Will is 
back creating content for the magazine. We’ll have a 
word with him and see if we can convince him to do 
more tutorials on external storage for a forthcoming 
issue. Thanks for reading! 


WRITE TO US 


Have you got something you'd like to soy? 

Get in touch via magpi(i)raspberrypi.org or on The 
MagPi section of the forum at raspberrypi.org/forums 


raspberrypi.org/magpi 
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Column 


MAH RICHARDSON 


THE FINAL WORD 



Matt is Raspberry Pi’s US-based product evangelist. Before 
that, he was co-author of Getting Started with Raspberry Pi 
and a contributing editor at Make: magazine. 


TAKING PI TO 
NEW HEIGHTS 


Why is a Raspberry Pi in space so exciting? Matt Richardson 
explores the universe of possibilities 


O rbiting earth at 27,600 kilometres per hour, 
the International Space Station is home 
to six crew members working on scientific 
research in a microgravity environment. By the end 
of this year, there will be two Raspberry Pis joining 
them on board. There are a lot of reasons why this is 
significant and exciting. In fact, sometimes when Pm 
reading an update about the mission on the official 
Raspberry Pi blog, I shake my head in disbelief. 

On board the International Space Station, the 
Raspberry Pis will run programs designed and 
written by British primary and secondary school 
students. It’s all a part of our Astro Pi competition, 
a partnership with the European Space Agency and 
the UK Space Agency. To help students with their 
on-board experimentation, each Raspberry Pi will 
be outfitted with a camera and a Sense HAT add-on 
board, which has sensors for position, movement, 
temperature, pressure, and humidity. In order for the 
crew to interact with the students’ creations, there’s 
also an 8 by 8 pixel RGB LED display, a joystick, and a 
few buttons. 

It’s exciting that Raspberry Pis are being launched 
to operate on the International Space Station. But, 
as I’ve learned in the past few months, getting a 
Raspberry Pi up there is no small feat. Long before it 
will be loaded onto the Soyuz rocket to be launched 
into space with astronaut Tim Peake, the Raspberry 
Pi and its accessories must undergo a battery of 
tests in order to receive its certification to be 
operated on board the space station. I’m excited to 
know that our own Raspberry Pis here on Earth are 
space-flight certified! 

Even more exciting than seeing Raspberry Pis 
on the International Space Station is how much it 
can motivate and inspire young kids to learn about 
computer science. As I’ve written before, we shouldn’t 


only teach coding for the sake of coding. We should 
think of coding as a means to accomplish something 
that interests students. The science of space is such 
a captivating subject matter for so many students 
and this is a great opportunity for them to code with 
purpose. I remember myself as a kid being incredibly 
interested in space travel. I could imagine the younger 
version of me being captivated and challenged by the 
Astro Pi competition. 

CodG in space 

For the winners of the competition, it’s also an 
incredible opportunity for them to run their own 
code on the ISS. According to Space.com, there 
are 3.3 million lines of code in ground computers 
and 1.8 million lines of flight software code, all of 
which must be carefully written and tested. Not just 
anyone can write code that runs on the ISS, because 
it’s so critical that everything works properly. The 
Raspberry Pis on the ISS will be isolated from the rest 
of the life-supporting hardware on board, acting as 
a sandboxed environment for running code on the 
station. It’s a unique opportunity for kids to have 
their code run safely in space. 

It’s a sandbox that can be replicated down here 
on Earth at the low cost of a Raspberry Pi. I’m 
sure that most of the other flight hardware on the 
International Space Station carries a hefty price 
tag. But now it’s affordable to own the very same 
hardware that will be orbiting Earth by the end 
of the year. 

For all these reasons, it’s exciting to see a 
Raspberry Pi go to space. If you’re anything like 
me, you can see each and every Raspberry Pi as a 
computer with enormous potential. It’s incredible 
to see the potential of Pi now going beyond the 
Earth’s horizon. 
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Use a browser from 
any device to proarom 
cund monitor your 
Rospberrij Pi 



Prosram and monitor 
^ur Pi from on^jwhere 
in the Internet 




Just dras & drop biocks 
to create ijour opplico- 
tions, usins Visual 

Useourarophsto Proa'on'-oina 

display your sensors' 
data 



now 


VNC 

RASPBERRY PI! 


RealVNC has released VNC for Raspberry Pi, which means 
you can now connect to your Pi from any Windows, Mac 
or Linux computer, or iPhone, iPad or Android devicel 



Check out our video tutorial to see how you can set up 
VNC Server on your Raspberry Pi. 

Watch the video here: https://www.youtube.com/user/RealVNCLtd 


R Download VNC: www.realvnc.com/download/ 

Y Getting connected: www.realvnc.com/products/vnc/raspberrypj/ 

▼ C For more information contact sales@realvnc.com 
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IQaudIO 

Audiophile accessories for the Raspberry Pi 



Pi-DAC+ 

• Raspberry Pi HAT, no soldering required 
Fult-HD Audio (up to 24bjt/1 92kHz) 

• Texas Instruments PCM5122 

• Line-out through Phono (RCA) sockets 

• Headphone Amp with 3.5mm socket 

• Oul-oMhe-box Raspbian support 

• Integrated hardware volume control 

• Access to Raspberry Pi GPIO 

• Connects to your own HiFI’s line-in/aux 



Pi-DigiAMP+ 

• Raspberry Pi HAT, no soldering required 

• Up to 2x30w of crystal clear stereo amplification 

• Full-HD Audio (up to 24bit/1 92kHz) 

• Out-of-the-box Raspbian support 

• Integrated hardware volume control 

• Provides power to the Raspberry Pi 

• Software controlled AMP mute on GPI022 
I/O available {i2c, 3v. 5v, Ov, GPI022/23/24/25) 

• Add speakers for a complete HiFi streaming solution 

• Designed for custom install, retro radio restoration, in car, etc. 

• TheMagPi - 4 star review 


Buy direct @ www.iqaudio.com 



Supported applications 


rune hi audio 


moOde 

audio player 
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PiMusicBox 


piCorePleyer 

SQUEEZE AUDIO DEVICE 


’ Archphlle 

Ooeenelec VOLUflTlIO 

Mike Brady's Shairport-Sync Pete Manchester's MediaPiayer 

AND MANY MORE ... 


Email: infQ@iqaudio.cQm 

WWW.IQAUDIO.COM 

IQaudto Limited, 

Twitter: @IQ_audio 

14 Ulysses Road 
Swindon SN25 2JR 




Company No,; 9461 908 







